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This quick reference guide contains condensed 
information about the commands in Section 1 of the 
ULTR1X-32 Reference Pages. 

The first section of the guide contains information 
about some of the more complicated commands in 
Section 1: 

• adb 

• dbx 

• ed 

• ex 

• vi 

• sh 

• csh 

• sees 

• mail 

• nroff and troff 

• ms 

• mh 

The second section of this guide condenses the rest of 
the Section 1 commands. 

To use this guide effectively, you should be familiar 
with the commands. For thorough specifications, of 
course, refer to the Section 1 Reference Pages. 
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Details of Selected Commands 1 


This section details some of the more complicated 
commands from Section 1 of the Reference Pages. 
These commands are: 

• adb Debugger 

• dbx Debugger 

• ed Text Editor 

• ex Text Editor 

• vi Screen Editor 

• sh Bourne Shell 

• csh C Shell 

• SCCS Commands 

• mail Commands 

• nroff and troff Primitives 

• ms Macro Package 

• mh Message Handler 







adb Debugger 

adb [- w] [- k] [- I dir] [objfll [corfU]] 

Options 

objfil Normally an executable program file, 

preferably containing a symbol table. Default 
is a.out. 

corfil A core image file produced after objfil is 
executed. 

- I dir Specifies a directory where files to be read 

with $< or $<< will be sought. Default is 
/usr/lib/adb. 

- k Specifies kernel memory mapping. Should be 

used when core is a crash dump or 
/dev/mem. 

- w Creates objfil and corfil if necessary, and 

opens them for reading and writing. 


Commands 

t 

Escape and execute shell command. 

newline 

Repeat last command. 

>name 

Set dot to the variable or register 

7[ format] 

named. 

Print from object file. 

?*[format] 

Print from object file using second 

/[format] 

mapping triple. 

Print from core file. 

l*[format] 

Print from core file using second 

- [format] 

mapping triple. 

Print address. 


Formats 


o 

O 

q 

Q 


Print 2 bytes in octal. 
Print 4 bytes in octal. 
Print signed octal. 

Print long signed octal. 
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d Print short decimal. 

D Print long decimal, 

x Print 2 bytes in hex. 

X Print 4 bytes in hex. 

u Print as unsigned decimal. 

U Print as long unsigned decimal, 

f Print 32-bit floating point number. 

F Print double-floating point, 

b Print 1 byte in octal, 

c Print addressed character. 

C Print addressed character. Control 

characters are printed as * X, the delete 
character as *?. 

s n Print the addressed characters until a zero 
or n is reached. 

S n Print a string, n is length of string. 

Y Print 4 bytes in date format, 

i n Print as machine instruction, 

a Print value of dot in symbolic form. Types 

are: 

I Local or global data symbol 

? Local or global text symbol 

= Local or global absolute symbol 

p Print addressed value in symbolic form, 

t Tabs to appropriate tab stop, 

r Print a space, 

n Print a newline. 

Print the enclosed string. 

Dot is decremented by the current 
increment, nothing is printed. 

+ Dot is incremented by one. Nothing is 

printed. 

Dot is decremented by one. Nothing is 
printed. 

[?/]l value mask 

Value mask words with mask until value 
found. 

[?/]w value 

Write value into addressed location. 
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[?/]m bl el fll?/) 

Change map parameters. 


Command 


$modifier 

Miscellaneous commands 

Modifiers 


<f 

>f 

r 

Read commands from file f. 

Append output to file f. 

Print registers and instruction addressed 

b 

by pc. 

Print all breakpoints, counts, and 
commands. 

c 

d 

Call stack backtrace. 

Set default radix to address and report 
new value. 

e 

w 

Print external variables. 

Set page width to address. Default is 
80. 

s 

Set limit on number of symbol matches 
to address. Default is 255. 

o 

q 

V 

m 

P 

? 

Set default for integer input to octal. 
Exit from adb. 

Print all nonzero variables in octal. 

Print the address map. 

Set process context. 

Print process ID. 

Command 


:modifier 

Manage a subprocess 

Modifiers 


be 

Set breakpoint at address , c is 
command to execute. 

d 

Delete a breakpoint at address. 
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r 

c s 
ss 


Run object file as a subprocess. 
Continue subprocess with signal s. 
Single step subprocess s number of 
times. 

k Kill subprocess. 


Variables 

0 

1 

2 

9 

b 

d 

e 

m 

s 

t 


Last value printed 

Last offset part of an instruction 

source 

Previous value of variable 1 

Count on last $< or $<< command 

Base address of data segment 

Data segment size 

Entry point 

Magic number 

Stack segment size 

Text segment size 


Expressions 


integer 


integer, fraction 
'cccc ' 

<name 

symbol 
_ symbol 
routine.name 
(exp) 


The value of dot 

Dot plus increment 

Dot minus increment 

Last address typed 

Decimal number, octal if it starts 

with Oo or OO, decimal if it starts 

with Ot or OT, hex if it starts with 

Ox or OX. 

A 32-bit floating point number 
The ASCII value of up to four 
characters 

The value of variable or register 
name 

The value of symbol 
The value of an external symbol 
Address of variable name in routine 
The value of expression exp 
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Monadic 

operators 


*exp 

Contents of location addressed 
in corfil 

by exp 

@ exp 

Contents of location addressed 
in objfil 

by exp 

- exp 

Integer negation 


'exp 

Bitwise complement 


tiexp 

Logical negation 


Dyadic operators 


el+e2 

Integer addition 


el-e2 

Integer subtraction 


el*e2 

Integer multiplication 


el%e2 

Integer division 


el&e2 

Bitwise conjunction 


el\e2 

Bitwise disjunction 


eltie2 

El rounded up to the next multiple of 
e2 
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dbx Debugger 

dbx [- r] [- i] [- k] [- Idir] [- c file] [objflle 
[coredump]] 


objfile 

An object file containing symbol 
information. 

coredump A file containing a core dump. 

Options 

- r 

Executes objfile immediately; prompts 
only on error. 

- i 

Assumes standard input is a terminal. 

- k 

Maps memory addresses for kernel 
debugging. 

- I dir 

Adds dir to directory search path. 

- c file 

Executes commands in file before 
reading from stdin. 


Commands 

Execution and Tracing Commands 

run [args] [<fHename] [>filename] 
rerun [args] [<filename] [>filename] 

Start executing objfile , passing args as command 
line arguments: < or > can be used to redirect 
input or output. Using rerun without arguments 
passes the previous argument list to the 
program. 

trace (in procedure/function] [if condition] 
trace source-line-number [if condition] 

trace procedure/function [in procedure/function] [if 

condition] 

trace expression at source-line-number [if 
condition] 

trace variable [in procedure/function] [if 
condition] 

Traces the expression or variable at the 
specified line or routine. 
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stop if condition 

stop at source-line-number [if condition] 

stop in procedure/function [if condition ] 

stop variable [if condition] 

Stops execution when the given line is 
reached, procedure or function called, 
variable changed, or condition true. 

status [> filename] 

Displays active trace and stop 
commands. 

delete command-number... 

Removes all traces or stops 
corresponding to the given numbers. 
Delete* removes all existing breakpoints 
and tracepoints at once. 

catch number or signal-name 

ignore number or signalrname 

Start or stop trapping a signal before it 
is sent to the program. 

cont [signal] 

Continues execution from where it stopped, 
passing signal if specified. Signal may be 
specified by name or by integer value. 

step 

Executes one source line, stepping into 
procedures. 

next 

Executes up to the next source line, 
stepping over procedures. 

return [procedure] 

Continues until return to procedure is 
executed, or until the current procedure 
returns if none is specified. 
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call procedure(parameters) 

Executes the object code associated with 
the named procedure or function. 

Printing Variables and Expressions 

assign variable = expression 

Assigns value of expression to variable. 

dump [procedure] [ > filename] 

Prints names and values of variables in 
given procedure. If procedure given is 
then all active variables are 
dumped. 

print expression [, expression...] 

Prints out values of the expressions. 

what is name 

Prints declaration of the given name, 
which identifier 

Prints full qualification of the given 
identifier. 

whereis identifier 

Prints full qualification of all occurrences 
of the given identifier. (See which.) 

where 

Prints a list of active procedures and 
functions. 

down [count] 
up [count] 

Moves the current scope up or down the 
stack count levels. Default is 1. 

Accessing Source Files 

/regular expression[/] 

?regular expressionl ?] 

Search forward (/) or backward (?) in current 
source file for given pattern. 
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edit [ filename] 

edit procedure/function-name 

Invokes default editor on filename or current 
source file if unspecified. 

file [ filename ] 

Changes current source file name to filename . 

fundproce dure/function] 

Changes current function. 

list [source-line-number [ ,source-line-number ]] 

list procedure/function 

Lists specified source lines or procedure. 
Default is 10 lines unless range is specified. 

use directory-list 

Sets directory search path for source files. 


Command Aliases and Variables 


alias 

name name 


alias 

name “string” 


alias 

name (parameters) “string” 
Defines an alias for name. 

If no 


parameters are specified, all 
displayed. 

aliases are 


set name [= expression] 

Defines debugger variable. 

The following have special meaning: 

$frame 

Specifies stack frame. Useful in kernel 
debugging. 

$hexints 
$hexchars 
$hexoffsets 
$ hex strings 
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Prints characters, integers, offsets from 
registers, or character pointers in 
hexadecimal. 

$list window 

Specifies number of lines to list around a 
function. Default is 10. 

$mapaddrs 

Starts or stops address mapping. 

$unsafecall 

$unsafeassign 

Turns off typechecking for subroutine calls, 
system calls, or between two sides of an 
assignment statement. 

unalias name 

Removes alias. 

unset name. 

Deletes definition or alias of name. 

Machine Level Commands 


tracei 

[address] [if cond] 

tracei 

[variable] [at address] [if cond] 

stopi 

[address] [if cond] 

stopi 

[at] [address] [if cond] 

stepi 

nexti 

Trace, stop, or step by machine 
instruction rather than by source 
line. 

address , 

, address/ [mode] 

address / [count] [mode] 


Displays memory contents from first 
address up to second address or 
until count items are displayed. 

The following modes specify how 
memory is to be displayed: 


Details of Selected Commands 1-11 





b Displays a byte in octal, 

c Displays a byte as a character, 

d Displays a short word in decimal. 

D Displays a long word in decimal. 

f Displays a single precision real 
number. 

g Displays a double precision real 
number. 

i Diplays machine instruction, 

o Diplays a short word in octal. 

O Displays a long word in octal. 

s Displays string of characters 

terminated by a null byte. 

x Displays a short word in 

hexadecimal. 

X Displays a long word in hexadecimal. 

Miscellaneous Commands 

help Displays a synopsis of dbx 

commands. 

quit Exits dbx. 

sh command-line 

Passes command line to the shell 
for execution. The SHELL 
environment variable determines 
which shell is used. 

source filename 

Reads dbx commands from given 
filename. 
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ed Text Editor 

ed [-] [- x] (file] 
red [-] [- x] [file] 

file Name of file to be edited. 

Suppresses display of character 
counts. 

- x Similates x command. 


Commands 


a 

Append text. 

c 

Change text. 

d 

Delete text. 

e file 

Edit file. 

E file 

Edit file, but display no 


warning message. 

f file 

Change name of current file to 


file. Default is current file 


name. 


(l,$)g /RE/command list 

Execute commands globally on 
each line containing search 
expression (RE). 

(1 ,$)G/RE/ Interactively execute commands 
globally on each line containing 
search expression (RE). 
h Displays short error message 

explaining reason for most 
recent ? diagnostic. 

H Displays error message for all 

subsequent ? diagnostics and 
previous ?. 
i Insert text, 

j Join lines, 

kx Mark line with character x. 

1 List lines and give ASCII 

equivalents for nonprintable 
characters. 

ma Move addressed lines after line 

a. 
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n 

P 

P 

q 

Q 

($)r file 
s /RE/rep/ 


s /RE/rep/g 


Number and list each 
addressed line. 

Print text lines. 

Turns on and off ed prompt. 
Quit edit session. 

Quit edit session and issue no 
warning message. 

Read file after the addressed 
line. 

Substitute replacement 
expression (rep) for search 
expression (RE). 

Substitute replacement 
expression (rep) for every 
occurrence of search expression 


(RE). 

t a Copy lines to address a. 

u Undo the previous substitution. 

(1,$) v/RE/command list 

Execute command list on all 
lines that do not contain 
search expression (RE). 

(1 ,$)V/J?2?/ Execute interactive global 

command on all lines that do 
not contain search expression 
(RE). 


(l,$)w file Write lines to file. 

X Demands a key string from the 

standard input. 

($) = Print current line number. 

\shell command 

Execute shell cmd. 

(.+ 1) <newline> 

Print next line. 
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ex Text Editor 

ex [-] [- v] [- t tag] [- r] [+ command] [- 1] 
name... 

edit [ex options] 

name Name of file to be edited. 

Options 


- v 

- t tag 


- r 


-1 


Commands 

a Append text, 

c Change text, 

co Copy text lines, 

d Delete text lines, 

e file Edit file. 

f Print current file name. 

g/exp/cmds/ Execute commands globally on all 
lines containing search expression 
( exp ). 

i Insert text, 

j Join text lines. 

1 List text lines and show tabs and 

end of lines. 

ma x Mark line with character 

argument x. 


Suppress all interactive user 
feedback. 

Equivalent to vi command. 

Edit the file containing the tag 
and position the editor at its 
definition. Equivalent to an 
initial tag command. 

Recover named file after an 
editor or system crash. If no 
file is specified, display a list of 
saved files. 

Set the showmatch and lisp 
options. 
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m addr 

Move text lines after addr. 

n 

Edit next file. 

nu 

Number and list each addressed 
line. 

o 

Open new line for text insertion. 

P 

Print text lines. 

pu 

Put back deleted or yanked lines. 

q 

Quit edit session. 

r file 

Read file into buffer. 

set 

Set or list ex options. 

sh 

Execute shell. 

si exp/rep/ 

Substitute replacement expression 
(rep) for search expression (exp). 

u 

Undo last editing command. 

vi 

Enter vi (full-screen display) 
mode. 

w file 

Write buffer back to file. 

X 

Exit edit session and write to 
file, if necessary. 

y 

Yank specified lines to buffer. 

! cind 

Exit and execute the specified 
command (cmd). 
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vi Screen Editor 

vi [- t tag] [- r] 1+ command] [- 1] [- wn] 
name ... 


Screen Control Commands 


<CTRL/L> Reprints current screen. 

<CTRL/R> Reprints current screen and 
eliminates @ lines. 

z<RETURN>Moves current line to top of 
screen. 

z “ Moves current line to bottom 

of screen. 


z. 

/patter n/z- 
z n. 

<CTRL/Y > 
<CTRL/E> 
n <CTRL/E > 
ncCTRL/Y > 


Moves current line to center 
of screen. 

Moves line containing pattern 
to bottom of screen. 

Sets screen size to n lines. 
Exposes one more line at 
top of screen. 

Exposes one more line at 
bottom of screen. 

Exposes n more lines at 
bottom of screen. 

Exposes n more lines at top 
of screen. 


Paging Commands 


<CTRL/F> 
<CTRL/B > 
<CTRL/D > 
<CTRL/U > 


Pages forward one screen. 
Pages back one screen. 
Pages down half screen. 
Pages up half screen. 


Cursor Positioning Commands 

J Moves cursor down one line, 

same column. 

n i Moves cursor down n lines, 

same column. 
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k Moves cursor up one line, 

same column. 

nk Moves cursor up n lines, 

same column. 

h Moves cursor back one 

character. 

nh Moves cursor back n number 

of characters. 

1 Moves cursor forward one 

character. 

n\ Moves cursor forward n 

number of characters. 

+ Moves cursor to beginning of 

next line. 

<RETURN> Moves cursor to beginning of 
next line. 

Moves cursor to beginning of 
previous line. 

* Moves cursor back to first 

nonblank space on current 
line. 

0 Moves cursor to beginning of 

current line. 

$ Moves cursor to end of 

current line. 

<SPACE> Moves cursor forward one 
character. 

n\ Moves cursor to column n. 

w Moves cursor forward one 

word. 

nw Moves cursor forward n 

number of words. 

b Moves cursor back one word. 

nb Moves cursor back n number 

of words. 

e Moves cursor to end of 

current word. When 
repeated, moves cursor to 
end of next word. 
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H 

Moves cursor to beginning of 
first line on screen. 

L 

Moves cursor to beginning of 
last line on screen. 

M 

Moves cursor to beginning of 
middle line on screen. 

nG 

Moves cursor to beginning of 
line n. Default is last line 
of file. 

fx 

Moves cursor forward on 
current line to next 
occurrence of x. 

Fx 

Moves cursor back on 
current line to previous 
occurrence of x. 

tx 

Moves cursor forward on 
current line to character 
before x. 

Tx 

Moves cursor back on 
current line to character 
before x. 

» 

Repeats previous f, F, t, or 

T command. 

» 

Reverses direction of f, F, t, 
or T command. 

/pattern 

Moves cursor forward to next 
occurrence of pattern. 

?pattern 

Moves cursor back to 
previous occurrence of 
pattern. 

n 

Repeats last / or ? pattern 
search. 

N 

Reverses direction of last / 
or ? pattern search. 

% 

Finds matching ( ), { }, or [ 

] if cursor on either one of 
the pair. 


Moves cursor to previous 
context. Functional only 
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after altering text or 
searching a pattern. 

” Moves cursor to beginning of 

previous context line. 
Functional only after altering 
text or searching a pattern. 

m* Marks current position with 

letter x [a-z]. 

‘x Moves cursor to position 

previously marked x. 

*x Moves cursor to beginning of 

line containing position 
marked x. 

J] Moves cursor to next section 

(for text containing 
formatting macros). 

[[ Moves cursor to previous 

section (for text containing 
formatting macros). 

) Moves cursor to beginning of 

next sentence. 

} Moves cursor to beginning of 

next paragraph. 

( Moves cursor back to 

previous sentence. 

} Moves cursor back to 

previous paragraph. 

Text Insertion Commands 

a Appends text after cursor 

until stopped by pressing the 
escape key. 

A Appends text at end of 

current line until stopped by 
pressing the escape key. 
Same as $a. 

i Inserts text before cursor 

until stopped by pressing the 
escape key. 
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o 

< CTRL/D > 

<CTRL/OD > 

<CTRL/H > 

<DELETE > 

<CTRL/T > 

<CTRL/W > 

<ESC> 

<CTRL/V> 

Text Deletion 

dw or dW 
x 
X 
nx 

dw or dW 


Inserts text at beginning of 
current line until stopped by 
pressing the escape key. 

Same as * i. 

Opens new line below current 
line for text insertion until 
stopped by pressing the 
escape key. 

Opens new line above current 
line for text insertion until 
stopped by pressing the 
escape key. 

Backs out text one shift 
width. Auto indent must be 
set. 

Backs out text to left edge 
of screen. Auto indent must 
be set. 

Overwrites last character 
during text insertion. 
Overwrites last character 
during text insertion. 

Indents text one shift width. 
Shift width must be defined. 
Deletes previous word during 
text insertion. 

Stops text insertion. 

Inserts and displays following 
control character (next 
argument). 

Commands 

Deletes current word. 

Deletes current character. 
Deletes previous character. 
Deletes n characters. 

Deletes current word. 
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ndw 

Deletes n words. Default is 
current word (or remainder 
of current word). 

de 

Deletes current word but 

dd 

ndd 

ncy 

leaves punctuation. 

Deletes current line. 

Deletes n lines. 

Deletes current line plus 
next n lines. 

D 

Deletes from cursor to end 
of line. 

d /pattern 

Deletes all text up to 

dfx 

pattern. 

Deletes text through the 


given x. 

Text Change Commands 

Change commands work with objects, put 
you into insert mode, shift text to right or 
left to fit, and must be ended with the 


escape key. 


cc 

Changes characters on 
current line until stopped 

ncc 

cw or cW 

with escape key. 

Changes n (number) of lines. 
Changes characters of current 
word until stopped with 

new 

escape key. 

Changes characters of next n 
words. 

c$ 

Changes text up to the end 
of the line. 

ct.r 

Changes text up to the given 
letter x. 

C 

Changes remaining text on 
current line until stopped by 
pressing the escape key. 

Changes case of current 
character. 
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xp Transposes current and 

following characters. 

J Joins current line with next 

line. 

>> Moves current line one shift 

width to the right. 

<< Moves current line one shift 

width to the left. 

>L Moves all lines between 

cursor and end of screen one 
shift width to the right. 

<L Moves all lines between 

cursor and end of screen one 
shift width to the left. 

n<< or n >>Moves n number of text 

lines one shift width to left 
or right respectively. 

Text Replacement Commands 

Replacement commands work on a single 
character or to the end of the line, put you 
into overwrite mode, do not shift any text, 
and must be ended with the escape key. 

rx Replaces current character with 

x. 

R Replaces existing text on 

current line until stopped with 
the escape key. 

Text Substitution Commands 

Subsitution commands work on a character 
or line and can be repeated, put you into 
insert mode, shift text from right or left to 
fit, and must be ended with the escape key. 

s Substitutes text for current 

character until stopped by 
pressing the escape key. 
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5 Substitutes text for current 

line until stopped by pressing 
the escape key. 

:s Substitutes new word(s) for 

old. Written as: 

:<addr range > s/old/new/g, 
where addr range is a range of 
line numbers. Example: :1,$ 
s/car/truck/g. 

6 Repeats last substitution (:s) 
command. 

Undo and Redo Commands 

These commands apply to all text alteration 

activities. 

u Undoes last change made. 

U Restores current line. 

. Repeats last change. 

Buffer Usage Commands 

nY Yanks n lines to unnamed 

buffer. Default is current line. 

yy Yanks current line to unnamed 

buffer. 

nyy Yanks n lines to unnamed 

buffer. Default is current line. 

"np Puts back text from nth 

previous delete (1-9). 

yw Yanks current word to 

unnamed buffer. 

ynw Yanks n words to unnamed 

buffer. 

p Puts yanked text line( s) after 

current line or yanked words 
after cursor. 

P Puts yanked text line( s) before 

current line or yanked words 
before cursor. 
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"xnY 

Yanks n lines to buffer x [a-z]. 
Default is current line. 

"xyL 

Yanks text from cursor to end 
of screen into buffer x[a-z]. 

" xy/pattern 

Yanks text from cursor to 
pattern into buffer x[a-z]. 

"xndd 

Deletes n lines and saves them 
in buffer x[a-z]. Default is 
current line. 

"x V 

Puts text from buffer x[a-z\ 
before current line. 

"xP 

Puts text from buffer x[a-z ] 
after current line. 


You may also yank, copy, or delete a vi 
command into a named buffer and then 
execute the command with @x t where x is 
any letter a-z that you have used to name 
the buffer in which you have put your 
command. 
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File Manipulation Commands 


:w file 

Writes changes to file. 

Default is current file. 

:wq 

Writes changes to current file 
and quits edit session. 

:w! file 

Overwrites file. Default is to 
overwrite current file. 

:q 

Quits edit session (no changes 
made). 

:q! 

Quits edit session and discards 
changes. 

:e file 

Edits file. 

:e! 

Discards changes and reedits 
current file. 

:e +n file 

Edits file and places cursor at 
line n. Default is to place 
cursor at end of file. 

:e# 

Edits alternate file. Allows 
shifting of text between files 
by using named buffers. 

:sh 

Executes shell and then 
returns to edit session. 

:\cmd 

Escapes to execute cmd and 
then returns to edit session. 

:n 

dits next file in argument list. 

:f name 

Changes name of current file 
to name. Default is to print 
name of file and current line 
number. 

<CTRL/G > Displays current file name and 
line number. 

:r file 

Reads contents of file into 
current file at current cursor 
position. 

:so file 

Sources given ex or vi 
command file. 

:set nu 

Numbers each text line. 
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Command Filters 

A command filter takes input from the 
buffer, modifies it, and inserts its output back 
into the buffer in place of the input text. 

^command Uses text of cursor positioning command 

x buffer as standard input to the given 
command and replaces the buffer text 
with output from the command. 

Example: IGsort will sort all text to the 
end of the file, then replace those lines 
with the sorted output. 

!!command Performs the command on the current 

line, then replaces the current line with 
the output from the command. 

Example: 4!!sort will sort the next 4 
lines and replace those lines with the 
sorted output. 

:r ! comm and Reads in the output of the command 

after the current line. Example: :r Idate 
will add the date after the current line. 

:w !command Sends contents of the buffer to a 
command without affecting them. 
Examples: :w !wc will count the buffer 
contents; :w llpr will print the buffer 
contents;:l,25w !lpr will print lines 1 
through 25. 

Startup Commands 

Map commands and named command buffers can be set 
up in the EXINIT variable located in the .login file in 
your home directory. This creates your editing 
environment whenever vi is invoked. Unused keys 
available for vi command mapping are K, V, g, q, v, *, 

=. It is also possible to redefine any built-in vi 
command keys, as shown in the following example (E, 
s and S). 
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Example .login file EXINIT setting: 


setenv EXINIT ’set ai aw ic sw=4 redraw terse|map g 
G| map v ~ |map E :e#<CTRL/M>|map s 

eas<esc>| map K G:r Mspell %<CTRL/M> |map S 
Gi/ \<escA \>escO" ad$dd@ a<CTRL/M >’ 


ai 

aw 

ic 

sw 

Auto indent 

Auto write 

Ignore case on searches 

Shift width = 4 spaces ( <, >, 
CTRL/D, CTRL/T). 

redraw 

terse 

wm 

Redraw screen after deletes. 

Terse error messages. 

Warp margin (spaces from right edge 
of screen). Automatic line splitting. 

ws 

Wrap scan around end of buffer on 
searches. 

map 

:mapu command 

Define your own commands. 

Map operator where x is any letter, 
command is any vi/ex command or 
combination of commands. 

Examples: :map g G causes g 
command to act like G; 

:map v causes letter v to 

change the case of the next 4 letters. 
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Source Command Files 

Editor options and key mappings that only affect the 
current invocation of vi can be specified in a file that 
you source after invoking vi. 

Examples: 

A file named .dialexrc containing commands “set 
noredraw slow" would be useful on a dial-in terminal. 

A file named .textexrc containing these commands could 
be used when editing English text: 

set ic wm= 10 
ab U ULTRIX 

ab UEG ULTRIX Engineering Group 

Invoke this command from within vi as follows: 

:so .textexrc 
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Bourne Shell Format 

sh [- ceiknrstuvx] [arg] ... 

arg Name of each command sequence to be 
executed. If not specified, invokes sh 
command for interactive execution. 

- c string Executes the specified commands. 

- e Exits immediately on unsuccessful 

execution of a command. 

- i Invokes sh for interactive session. 

- k Places all specified keywords into current 

execution environment. 

- n Reads all commands but does not execute 

them. 

- s Reads stdin until CTRL/D and uses this 

input as the command sequences to be 
executed. 

- t Exit after executing one command only. 

- u Treats all undefined variables as an error. 

- v Displays each input line upon execution. 

- x Displays all command sequences before 

execution. 

Turns off the - x and - v options. 


Command Execution 

cmdl | cmd2 Pipes output of cmdl as input to 
cmd2. 

cmdl ; cmd2 Executes commands in succession. 
cmd & Executes cmd in background. 

cmdl && cmd2 Executes cmd2 only if cmdl succeeds. 
cmdl || cmd2 Executes cmd2 only if cmdl fails. 

Input/Output Redirection 

> file Redirects standard output to file. 

[n]> file Redirects file descriptor n to file output. 

< file Redirects standard input from file. 

[n]< file Redirects input from file to any file 

descriptor n. 
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>> file 

Redirects standard output and appends to 
file. 

[n]>> file 

Redirects file descriptor n and appends to 
file . 

<< word 

Reads standard input until encounters line 
containing only single word. 

>& n 

Duplicates file descriptor n and uses as 
standard output. 

[m]>& n 

Duplicates File descriptor n, appends data 
from File m to n and uses as standard 
output. 

<& n 

Duplicates file descriptor n and uses as 
standard input. 

[m]<& n 

Duplicates file descriptor n, appends file 
descriptor m to n and uses as standard 
input. 

<&- 

Closes standard input. 

>&- 

Closes standard output. 

File Name 

Generation 

9 

Matches any single character. 

* 

Matches any string of characters, including 
a null string. 

(xyz) 

Matches any of the enclosed characters 
(xyz). Initial dots are never matched. 

Variable Substitution 

$X 

Substitutes defined value for x. 

$• 

Substitutes all arguments for *. 

$@ 

Same as $* but quotes each argument. 

$- 

Substitutes option flags used to invoke 
current shell. 

$# 

Substitutes number of specified arguments 
for #. 

$? 

Substitutes exit status of last command 
for ?. 

$$ 

Substitutes process ID of current shell for 


$. 
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$! 

$HOME 

$PATH 

$MAIL 

$PS1 

$PS2 

$IFS 

$TERM 

$n 

${p-w} 
${p= w) 
${p?w} 


${p+ w} 

Quoting 

x 

’xxx ’ 

"xxx" 


Substitutes process ID of last background 
command for !. 

Substitutes path of default home directory 
for HOME. 

Substitutes default execution search paths 
for PATH. 

Substitutes path of your mail file for 
MAIL. 

Substitutes primary prompt string for PSl. 
Substitutes secondary prompt string for 
PS2. 

Substitutes interfield separators for IFS. 
Substitutes terminal type for TERM. 
Parameter at position n. 

Substitutes value for parameter if set; 
otherwise substitutes word. 

Substitutes value of parameter that is set 
to word. 

Substitutes value of set parameter. If not 
set, prints word and exits from shell. 
Prints standard message if word is 
omitted. 

Substitutes word for parameter if set. 


Quotes specified character x. 

Quotes specified character string xxx , 
including special characters: \ ", $ 

Quotes specified character string xxx t 
excluding \ \ ", $. 


The use of double quotation marks (“ ”) cause 
suppression of file name generation, while permitting 
the variable expression to be used. Single quotation 
marks (‘ ’) causes suppression of file name generation 
and variable substitution. 


Control Flow Constructs 

All of the following control flow constructs must be the 
first command in the list in order to be recognized. 
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for name [in word...] do list done 
case word in [patl [ pat2 ]...] list;;... esac 

if list then list [elif list then list]... 

[else list] fi 

while list [do list] done 


( list ) 

Executes commands in list in a 
subshell. 

{list} 

Executes commands in list in 
current shell. 

Serves as null command to identify 
line as comment. 

. file 

Reads in commands to be executed 
from specified file. 

break [n] 
continue [n] 

Exits from loop at specified level n. 
Continues with next iteration of loop 
at specified level n. 

cd [ arg] 

Changes current directory to arg. 

The shell parameter $HOME is the 
default arg. 

exit [n] 
eval [arg...] 

Exits with specified status n. 

Reads and executes each specified 

exec [arg...] 

argument. 

Executes each specified argument 
without creating a new process. If 
no arguments are given, shell file 
descriptors are modified with the use 
of input/output directional symbols. 

export [name... 

] Exports each named variable to 
current execution environment. 

login [arg...] 
read name 

Equivalent to ‘exec login arg 

Reads standard input and assigns 
name. 


readonly [name...] Marks each named variable readonly, 
set [- eknptuvx [ar#...]] 

Sets the following /bin/sh shell 
options: 
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- e Exits immediately if a command fails when 

not interactive. 

- k Places all keyword arguments in the 

environment for a command, not just those 
that precede the command name. 

- n Reads commands but does not execute 

them. 

- t Exits after reading and executing one 

command. 

- u Treats unset variables as an error when 

substituting. 

- v Prints shell input lines as they are read. 

- x Prints commands and their arguments as 

they are executed. 

Turns off the - x and - v options. 

shift 
times 

trap [ arg ] [n] 
urn ask [nnn] 


wait [n] 


Shifts positional parameters left: $1 
= $2 and so on. 

Prints accumulated process times. 
Executes arg only if signal n is 
received. 

Sets the user file creation mask to 
the octal value nnn. Default: Prints 
the current value of the mask. 

Waits for specified process (n). 
Default is to wait for all child 
processes. 
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C Shell Format 

csh [- cefinstvVxX] [arg ...] 

arg Name of each command to be executed and 
command options and arguments, if any. 

- V Displays verbose information as input is read. 

- X Displays command sequence before execution. 

- c Reads commands from specified file (next 

argument). 

- e Exits if command terminates abnormally. 

- f Invoked with fast start up: does not read .cshrc. 

- i Invokes interactive shell (default). 

- n Reads commands, but does not execute them. 

- s Reads input from stdin. 

- t Exits after one command. 

- v Displays input as read (verbose mode). 

- x Prints on execution. 

Command Execution 

cmdl | cmd2 

Pipes output of cmdl to input of cmd2. 
cmdl ; cmd2 

Executes commands in succession. 
cmd & Executes cmd in background. 
cmdl && cmd2 

Executes cmd2 only if cmdl succeeds. Exit 
status is 0. 
cmdl || cmd2 

Executes cmd2 only if cmdl fails. Exit status 
is 1. 

x Quotes specified character x. 

‘xxx* Quotes specified character string xxx, including 
special characters: 

“xxx” Quotes specified character string xxx, 
excluding \ * " $. 

( cmd) Executes cmd in a subshell. 
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Input/Output Redirection 

> file Redirects standard output to file. 

< file Redirects standard input from file. 

>> file Redirects standard output and appends it to 
file. 

<< word Reads standard input until it encounters any 
line containing only word. 

Input/Output Modifiers 

! Overrides noclobber. 

& Redirects standard error output also to 

specified file. 


File Name 

Generation 

? 

Matches any single character. 

* 

Matches any string of characters, including 
null string. 

[xy 2 ] 

Matches any of the enclosed characters 
( xyz ). There is an error if no match 
occurs. 

1 name 

Matches specified user’s {name) home 
directory. Default is to match your home 
directory. 


Matches any of the enclosed characters, 
preserving specified order, without errors. 


Variable Substitution 

§name Substitutes the value of a variable name 
for $name. 

$name[n] Substitutes the value of the nth member 
of %name. 

%name[mrn ] Substitutes the values of mth through nth 
members of %name. 

$Hname Substitutes the number of words in the 
value for the variable for $ttname. 

$0 Substitutes name of file from which 

command input is read for $0. 
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$n 

$* 

$? 

$$ 

Predefined 

argv 
cd path 

cwd 

echo 


history 

home 

ignoreeof 

mail 

noclobber 

noglob 

nonomatch 

notify 

path 

prompt 

shell 

status 

term 

time 

verbose 


Substitutes $argv[n] for $n. 

Substitutes all arguments to the shell for 

$*. 

Substitutes exit status of last command 
for $?. 

Substitutes process ID of parent shell for 

$$. 

Variables 

Contains array of arguments to the shell. 
Contains list of alternate directories to 
search for chdir command. 

Contains path for current working 
directory. 

Causes each command and argument to be 
echoed just before execution with all 
translations. 

Contains size of the history list. 

Contains path for home directory. 

Disables logging out by CTRL/D. 

Contains path for mail file. 

Prevents accidental file destruction. 

Inhibits file name expansion. 

Prevents errors in nonmatching file 
expansions. 

Notifies when job completes. 

Contains search paths for command 
execution. 

Contains prompt string. 

Contains path to shell program. 

Contains status return by last command. 
Contains terminal type. 

Controls printing of command timing 
Echos commands only with history 
substitutions. 


Control Flow Constructs 

foreach name (list) 
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end 


switch ( string) 
case strl: 


breaksw 

default: 


breaksw 

endsw 

if ( expr) cmd or if ( expr) then 

else if ( expr2 ) then 


else 


endif 

while (expr) 


end 
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Shell Commands 

<CTRL/Z> Stops current job. 
alias [name] [sting] 

Sets string alias for name. Without 


alloc 
bg [%n] 
beak 

the string, displays alias for name. 
Without both name and string, 
displays all aliases. 

Displays current memory usage. 

Puts specified job (n) in backgound. 
Resumes execution after closest 
foreach or while statement. 

cd [name] 

Changes working directory to named 
directory. 

continue 

Continues execution of closest foreach 
or while statement. 

dirs 

Prints names in current directory 
stack. 


echo [- n] [/is/] Echoes each argument in specified list 


eval arg... 

with newline at the end, unless - n. 
Reads and executes each specified 
argument. 

exec cmd 

Executes cmd in place of current 
shell. 

exit 

fg [%n] 
glob list 

Quits current shell. 

Puts specified job in) in foreground. 
Similar to echo, but no escapes or 
null delimiters 

goto string 
hashstat 
history 
jobs 

kill - sig job 

Transfers execution to string. 

Displays hash table statistics. 

Displays history list. 

Displays status of active jobs. 

Sends signal to the job. The default 
signal is SIGTERM. Kill - 1 displays 
the signals. 

limit 

login 

Sets job limits. 

Invokes /bin/login in place of login 
shell. 

logout 

Terminates login shell. 
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newgrp 

nice 

nohup 

notify 

onintr 

popd [+n] 

Changes group identification. 

Alters execution priority. 

Ignores hangups. 

Notifies of job completion. 

Specifies interrupt handling. 

Removes top or nth entry from 
directory stack. 

pushd 

Exchanges top two elements on 
directory stack. 

pushd name 

Changes directory to name and 
pushes name on directory stack. 

rehash 

Recomputes command location hash 
table. 


repeat n and Repeats and n times, 
set [name] [ string ] 

Set shell variable (name) to string. 
Default is to display all variable 
settings. 

setenv name string 

Sets environment variable ( name) to 


shift 

source name 

string. 

Shifts argv list left one position. 

Reads commands for current shell 
from name. 

stop [% n] 

Stops specified job (n). Default is to 
stop current job. 

suspend 
time [cmd] 

Stops current shell. 

Displays summary of execution times 
for cmd. Default is to display times 

umask mode 

for current shell. 

Turns off specified permission bits 
(mode) on all created files. 

wait 
% n 

@ 

Waits for background jobs. 

Restates specified. stopped job (n). 
Displays value of all shell variables. 
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SCCS Commands 

sees command [command option] [file] [sees] 

Commands 

admin - Creates and administers SCCS files 

- a Adds user (- a login) to list of those 

permitted to make changes to SCCS files. 

-d Deletes specified SCCS flag i-dflag) from 
file. 

-e Erases user i-elogin) from list of those 
permitted to make changes to SCCS files. 

- f Turns on specified flag (- (flag ). 

- h Checks structure of SCCS file. 

-i Creates using specified file (-iname) as 
initial contents. 

- m Inserts specified modification request numbers 

( - m rlist) into SCCS file. 

- n Creates new SCCS file. 

- r Indicates initial delta release number 

( - r SID ). Used only with - i keyletter. 
Default is 1.1. 

- t Replaces descriptive text with contents of 

specified file (-t name). 

- y Inserts specified text (- y comment) as initial 

comment. 

- z Rebuilds the SCCS file checksum. 

Admin flags (used with f and d options): 

b Allows branches, 

c ceil Retrieves highest release by the get 

command for editing (must be a positive 
number no higher than 9999, the default 
number). 

ifloor Retrieves lowest release by the get 

command for editing (must be a positive 
number between 0 and 9999). Default 
is 1. 

dSID Sets default delta version number (d n) 
for get or edit commands. 
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i Treats “no id keywords” as a fatal 

error. 

j Allows multiple, concurrent updates to 

the same version of any SCCS file, 
using the get command for editing. 

1 list Specifies list of releases to which deltas 
can no longer be made. See admin(l) 
for syntax. 

n Creates a null delta in any release that is 

skipped when a delta is made in a new 
release. Example: Making delta 5.1 after 
2.7 skips releases 3 and 8. These are 
created but are null and serve as anchor 
points for branch deltas. 

q text Substitutes user definable text for all 

occurrences of the %Q% keyword in SCCS 
file text retrieved by get. 

m mod Substitutes module name of the SCCS file 
for all occurrences of the %M% keyword in 
file text retrieved by get. Default is name 
of the SCCS file with the leading s. 
removed. 

v[ pgm] Prompts for modification request (MR) 

numbers as the reason for creating a delta. 

t type Module type. 

cdc - Changes delta commentary 

- m [mrlist] Adds or deletes specified modification 

numbers (- m list ). Must be used 
with - r option. 

- r SID Indicates delta version number. 

- y [comment] Replaces comments already existing 

for the delta specified by the - r 
keyletter. 

check - Displays information only about files being 
edited and returns exit status. (Similar to 
info.) 

clean - Removes recreatables files. 
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comb - Combines deltas. 

- c Preserves specified deltas (- c list). 

- o Accesses reconstructed files at release of delta. 

- p Oldest delta to preserve (- p SID). 

- s Generates script that reports: file name, size 

(after), size (before), and percentage changed. 

create - Creates SCCS file. 

deledit- Produces a delta and gets new g-file for edit. 

delget - Produces a delta and gets new g- file 

delta 

- g Specifies list of deltas to be ignored - g(/is*]. 

- m Indicates modification request number 

(- m[mr/ist]). 

- n Does not delete edited file. 

- p Prints differences before and after deltas are 

applied. 

- r Indicates new delta release number (- r SID). 

- s Suppresses messages. 

- y Creates delta with specified commentary 

(- y [comment]). 

edit - Get SCCS file for editing 

- b Creates a branch 

-i Includes specified list of deltas (-i list). 

- r Gets specified version (- r SID) for editing. 

- x Excludes specified list of deltas (- xlist ). 

fix - Removes delta and edits earlier version 
get - Get copies of SCCS files 

~ Retrieves specified delta sequence number 
(- a seq-no .). 

- b Gets delta from branch. Used with - e. 

- c Does not apply deltas created after specified 

date-time (- c cutoff in the form 
YY[MM[DD[HH[MM[SS]]]]]). 
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- e Gets specified delta version for editing. Equal 

to edit. 

- g Suppresses getting text from SCCS file. 

- i Includes specified list of deltas (- i list). 

- k Does not expand ID keywords. 

- 1 Writes delta summary to I- file. 

- m Precedes each line with delta version number. 

- n Precedes each line with identification keyword. 

- p Writes text to stdout. 

- r Gets specified version number (- r SID). 

- s Suppresses all messages. 

- t Gets most recent (top) delta. 

-x Excludes specified list of deltas (- xlist ). 

info - Displays information about files being edited 

- b Ignores branches. 

- u Displays information about files edited by 

named user (-u name). 
prs - Displays information from SCCS files. 

- a Displays information for both existing and 

removed deltas. 

- d Displays information specified by dataspec 

(- d dataspec). 

- e Displays information for all deltas created 

before and including specified delta (-eS/D). 

- 1 Displays information for all deltas created 

including and after specified delta (- 1 SID) . 

- r Indicates delta version number ( - r n). 

- t Prints descriptive text. 

prt - Display changes made to SCCS files, 
rmdel - Removes deltas 
-r Removes specified version (-r SID). 
sccsdiff - Display differences between SCCS files. 

- p Pipes output through pr command. 

-r Specifies first delta (-rSIDl). 

- r Specifies second delta (- r SID2). 
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- s Specifies segment size for bdiff (- s n). 
sccshelp - Displays help for SCCS error messages. 

tell - Displays only names of SCCS files being 
edited. 

unedit - Undo SCCS edit command, 
unget - Undo SCCS get command. 

- n Retains copy of SCCS file. 

- r Indicates delta version number (- r SID ). 

- s Suppresses all messages. 

val - Validates SCCS files. 

-m Compares specified value (-m name) with 
keyword. 

- r Indicates delta version number (- r SID). 

- s Suppresses all error messages. 

-y Compares specified type (-y type) with %Y% 
keyword 

what - Displays SCCS ID keywords in object files. 
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mail program 

mail [- v] [- i] [- n] [- s subject] [user] 
mail [- v] [- i] [- n] - f [name] 


mail [- v] [- |i] [- n] - u user 


-f 

- i 

- n 

- s subject 

- u user 

- v 


Checks mbox or the specified file instead 
of your normal account for mail. 

Ignores all terminal generated interrupt 
signals. 

Ignores /usr/lib/Mail.rc during startup. 
Uses specified subject for mail header. 
Checks specified user’s account for mail. 
Displays verbose delivery information. 


Write and Send Commands 

a Sets or lists aliases. 

alt Lists addresses where messages are not to 

be sent. 

dn Deletes one message or range of 

messages. (For example: dl*10 deletes 
messages 1 through 10. Default is to 
delete current message. 

dp or dt Deletes current messages and prints next 
message. 

e Edits messages with ex editor, unless the 

.mailrc file set editor command specifies 
another editor. 

ex or x Exits from mail, with no modifications 

m Sends mail to current message sender. 

Use m name to specify another. 

q Quits mail session. 

R Routes reply to originator of message 

only. Does not reply to other recipients 
of the original message. 

r or respond Routes reply to sender and all who 
received message. 

se Sets options in form of “option= value” or 

“option”. If no argument if given, 
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u 

U/l 

unalias 

unset 


v 

!command 


displays all variable values. 

Undeletes all messages marked for 
deletion by the d command. 

Undeletes numbered message. 

Takes list of names defined by alias 
commands and cancels the list of users. 
Discards values assigned to option. The 
inverse of set. 

Edits messages with vi editor. 

Escapes to a shell, then executes the 
given shell command. 


Read Commands 


in or from Displays numbered message header. 

f displays current message header, 
f* displays all message headers, 
h Lists current range of headers, in 

message group determined by the speed 
of your terminal. Terminals with a baud 
rate of < 1200 list 5 headers, 10 if the 
baud rate is 1200, and 20 if the baud 
rate is > 1200. The default range can 
be overridden by the screen command, 
h n begins with message n. 
help Displays summary of mail commands. 

Identical 
to ? command. 

ignore Eliminates selected header items on 

displayed message. When used by itself, 
ignore displays the current list of 
ignored header fields, 
n Displays next message, 

p Displays messages on terminal. 

Identical to t. 

P Displays messages on terminal plus 

extensive header information. Identical 
to T. 
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size Lists size, in characters, of current 

message in mail directory, size* gives 
size of all messages. 

so Reads mail commands from a file. 

t Displays messages on terminal. 

Identical to p. 

T Displays messages on terminal plus 

extensive header information. Identical 
to P. 

topm Displays n number of top lines of 

message m, as determined by the 
variable toplines. Default is 5. 

z Displays windows of message headers. 

See h and screen commands for window 
sizes, z or z+ moves forward to next 
window; z- moves to previous window. 

+ Displays next message in sequence. 

Returns to previous message. 

? Displays summary of mail commands. 

<RETURN> Displays next message in sequence. 


Store Commands 


ch 

co n file 
ho n 
fi or file 
folder 


Changes directory to that specified. 
Default is login directory. 

Copies message n to file and does not 
delete that message from mail list. 

Holds message n in system mail box. 
ho* holds all messages. 

Switches to new mail file or folder. 
Identical to folder command. 

Switches to new mail file or folder. 

With no argument, tells you which file 
you are currently reading. With 
argument given, writes changes made to 
current file and reads in new file. 
Conventions used are: #, previous file; 

%, system mailbox; %user, user’s system 
mailbox; &, your 7mbox file; + folder, a 
file in your folder directory. 
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folders 

Lists names of folders in folder 
directory. 

mbox 

Sends message to mbox file after you 
quit mail session. 

pre 

Preserves message in system mailbox. 
Identical to ho command. 

s file 

Saves messages in a named file. 

sh 

Invoke /bin/sh shell. 

w file 

Writes message to a given file. 

Identical to s command. 

Tilde Escape 

Commands 

Tilde escapes 

are only recognized at the beginning of 

lines and are 

used to perform special functions when 

composing messages. 

1) name 

Sends blind carbon copy to specified 
user name. (Name will not be included 
in cc: list). 

c name 

Send carbon copy to specified user 
( name). 

d 

Reads mail from dead.letter file. 

e 

Edits message with ex editor. 

T message 

Reads message into message being sent. 

1i 

Edits the message header. 

tn message 

Reads message into message being sent, 
shifted one tab space to the right. 

'P 

Prints current message. 

q 

Quits current message, but saves 


contents in dead.letter file. (Be sure 
that nosave is not set in .mailrc file.) 


> filename 

Reads file named into the message. 

s string 

Substitutes string for current subject 
field. 

\ name 

Adds specified user ( name) to direct 
recipient list. 

V 

Edits message with vi editor. 

~w filename 

Writes message to file. 
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1 cmd 
~ 1 string 

Pipes message to cmd as a filter. 

Inserts text string in the message 
prefaced by a single ~. If the escape 
character has been changed, it must be 

Icmd 

-? 

doubled in order to send the message. 
Executes specified command (cmd). 
Executes mail commands. (Example: 

*il0 prints out message number 10). 
Displays brief summary of tilde 
commands. 


Binary Variables 

These options are controlled with the set and unset 
commands. Check first to see whether or not they are 
set. 


append 

ask 

askcc 

autoprint 

Appends messages to end of mbox file. 
Prompts for subject header. 

Prompts for carbon copy recipients. 

Causes d command to act like dt 
command. 

dot 

Interprets a period alone on a line as 
the terminator of the message is sent. 

hold 

Causes messages to be held in system 

ignore 

mailbox by default. 

Ignores interrupts from terminal, such as 
CTRL/C and CTRL/D, when set ignore 

ignoreeof 

= 1 . 

Refuses to accept CTRL/D as the end of 

metoo 

msgprompt 

a message. 

Includes self if in distribution list. 

Prompts for message text and indicates 
how to terminate the message, when 

nosave 

sending mail. 

Prevents the copying of an aborted 

save 

message to the dead.letter file. 

Saves interrupted messages in dead.letter 
file. 
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quiet Does not print mail version, 

verbose Puts mail into verbose mode, displaying 

message on the terminal when you send 
a message. 


String Variables 

EDITOR Contains path for default text editor 

no. 

Contains path for shell. 

Contains path for vi editor (V). 
Determines how long a message must be 
before more is used to read it. 

Contains default escape character. 
Contains name of directory to use for 
storing folders of messages. If name 
begins with /, it is considered to be an 
absolute pathname: otherwise, the 
directory is found relative to the home 
directory. 

Contains path for file in which all 
outgoing mail is saved. 

Defines window size for the h and z 
commands. Example: set screen = 18 
causes mail to display message headers 
in groups of 18. 

Contains number of lines to print for 
the top command. 


SHELL 

VISUAL 

crt 

escape 

folder 


record 


screen 


toplines 
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nroff and troff Primitives 

NOTE: Troff is not supported by Digital Equipment 

Corporation. 

Font and Character Control Primitives 

.ps n Sets point size to n (troff only). 

.ft x Changes font to x (troff only). 

.ul n If nroff, underlines next n input lines. If 

troff, italicizes next n input lines. 

Page Control Primitives 

,pl + _ n Sets page length to n. Default measure is 
n lines. 

.bp + - n Begins new page and numbers page n. 

.pn + - n Numbers next page n. 

.ne n Begins new page if n vertical space does 
not fit on current page. Default measure 
is n lines. 

.po + - n Sets left margin (page offset) to + - n. 
Default measure is n ems. 

Text Filling, Adjusting, Centering Primitives 


.br 

Forces break in text. 

.nf 

Does not fill or adjust text. 

.fi 

Begins text filling. 

.na 

Does not adjust text (ragged right 


margin). 

.ad x 

Adjusts text with mode x. 

.ce n 

Centers next n input lines. 

Ve rtical 

Spacing Primitives 

.Is n 

Sets line spacing: places n- 1 blank 


between output text lines. 

.sp + - n Sets vertical spacing: negative n spaces 
backwards. Default measure is n lines. 

Line Length and Indenting Primitives 

.11 + - n Sets line length to n. Default measure is 
n lines. 
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.in + - n Indents text by n. Default measure is n 
ems. 

.ti + - n Indents next output line n. Default 
measure is n ems. 

Macros, Strings, Number Registers Primitives 

.de xx Defines macro xx. (Characters .. on 
separate line ends definition.) 

.ds xx string 

Defines specified string (xx) to string. 

Calls contents of one-character string x. 
Calls contents of two-character string xx. 
.nr r xx Sets specified value (xx) to number 
register r. 

nx Calls contents of one-character register x. 

nxx Calls contents of two-character register xx. 

Conditional Primitives 


.if x cmds Executes specified commands (cmds), if 
condition x is true. 

.if !c cmds Executes specified commands ( cmds), if 
condition c is false. 

.if n cmds Executes specified commands (cmds), if 
n > 0. 

.if \n cmds Executes specified commands (cmds), if 
n <= 0. 

.if ’sfri’sfr2’ cmdsstrl’str2’ cmds*u>( 231u+ In) .br 

Executes specified commands (cmds), if 
strl is identical to str2. 

.if Vstrl > str2 > cmdsstrVstr2’ cmds } \x>( 231u+ In) .br 

Executes specified commands (cmds), if 
strl is not identical to str2. 

.ie c cmds Constitutes “if’ portion of “if...else” 

statement. Similar if statements above. 

.el cmds Constitutes “else” portion of “if...else” 
statement 
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Input/Output Options 

These options may appear in any order but must be 
used in the general form: 

nroff options files. 

- o list Prints only pages whose page numbers 

appear in the comma-separated list of 
numbers and ranges. Range N-M means 
pages N through M\ an initial -N means 
from the beginning of page N; and a final 
N- means from N to the end. 

- n N Number the first generated page N. 

- s N Stop printer every N pages to allow paper 

loading or changing, then resumes printing 
upon receipt of a newline. Default is 1. 

- m name Prepend macro file /usr/lib/tmac/tmac.name 

to the input files. 

- raN Set register a (one-character) to N. 

- i Read standard input after the input files 

are exhausted. 

- q Invoke the simultaneous input-output mode 

of the rd request. 

- T name Prepare output for the specified terminal 

( name). 

- e Produce equally spaced words in adjusted 

lines, using full terminal resolution. 

- h Use output tabs during horizontal spacing 

to speed output and reduce output 
character count. Tabs are assumed to be 
8 nominal character widths. 
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- ms Macro Package 

NOTE: Troff is not supported by Digital Equipment 
Corporation. 

Format Macros 


.1C 

Specifies 1 column format. 

.2C 

Specifies 2 column format. 

Paragraphs 

.PP 

Begins indented paragraph. 

.LP 

Begins left-adjusted paragraph. 

.IP XX 

n Begin indented paragraph: indents body j 
spaces and prints tag (xx) in margin. 

Section 

Head Macros 

.NH 

Specifies numbered section heading. 

.SH 

Specifies unnumbered section heading. 

Indent and Display Macros 

.RS 

Increases relative indent. 

.RE 

Ends relative indent. 

.DS jc 

Begins displayed text: indented but not 
filled. Values for x are: L (left-adjusted 
text) or C (centered text). 

.DE 

Ends displayed text. 

Keep Macros 

.KS 

Begins block of text to be kept together. 

.KF 

Begins floating keep: text kept together 
a unit, but output only when there is 
adequate space. 

.KE 

Ends keeps. 


Footnotes 

.FS Begins footnote text. 

.FE Ends footnote. 

Font and Point Size Macros 

.1 Begins italics (troff). Begins underlined 

text (nroff). 
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g Begins bold text ( troff) • 

R Begins Roman type (default). 

SM Changes to smaller point size (troff). 

LG Changes to larger point size (troff). 

’.NL Returns to normal point size (trott). 

'.UL Underlines specified word, 

eqn and tbl Preprocessors Macros 
.EQ Begins equation. 

.EN Ends equation. 

TS Begins table. 

TS H Begins table with repeated headings. 
’.TH Ends heading section of table. 

TE Ends table. 


Macros for Papers 


.DA 

.RP 


.TL 

.AU 

,AI 


.AB 

.AE 

.ND 


Forces date on each page. 

Begins released paper format: cover sheet 
with title and abstract. 

Specifies title on following line(s). 
Specifies author) s) on following lme(s). 
Specifies author’s institution on following 
lines. 

Begins abstract. 

Ends abstract. 

Does not print date. 
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mh -Message Handler 

Programs to send, receive, save, and retrieve messages. 

ali - list mail aliases 
Syntax 

ali [-alias alias file] [-list] [-nolist] [-normalize] 

I-nonormalize] [-user <useradr>] [-nouser] aliases ... 

[- help] 

anno - annotate messages 
Syntax 

anno [ + folder] [msgs] [—component field] [-inplace] 
[-noinplace] [-text body] [-help] 

burst - explode digests into messages 
Syntax 

burst [+ folder] [msgs] [-inplace] [-noinplace] [-quiet] 
[-noquiet] [-verbose] I-noverbose] [-help] 

comp - compose a message 
Syntax 

comp [+ folder] [msg] 

I- draft folder + folder] [-draft message msg] 

[-nodraft folder] [-editor editorname] [-noedit] 

[-file filename ] [-form formfile] [-use] [-nouse] 

[-whatnowproc program] [-nowhatnowproc] [-help] 
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dist - redistribute a message to 
additional addresses 

Syntax 

dist [+ folder] [msg] [-annotate] [-noannotate] 

[- draftfolder + folder] I- draft message msg] 

[-nodraftfolder] [-editor editorname] [-noedit] 

[-form formfile] [-inplace] [-noinplace] 

[-whatnowproc program] [-nowhatnowproc] [-help] 

folder - set folder or display current 
foldername 

Syntax 

folder [+ foldername] [msg] [-all] [-fast] [-nofast] 
[-header] [-noheader] [-pack] [-nopack] [-recurse] 

[-norecurse] [-total] [-nototal) [-print] [-noprint] [-list] 
[-nolist] [-push] [-pop] [-help] 


folders - list folders and contents 
Syntax 

folders [folder] [msg] [-fast] [-nofast] [-header] 
[-noheader] [-pack] [-nopack] [-recurse] [-norecurse] 
[-total] [-nototal] [-print] [-noprint] [-list] [-nolist] 
[-push] [-pop] l-helpl 

forw - forward messages 
Syntax 

forw [+ folder] [msgs] [-annotate] [-noannotate] 
[-draftfolder FI+folder] [- draft message msg] 
[-nodraftfolder] [-editor editorname] [-noedit] 
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[-filter filterfile) [-form formfile] [-format] [-noformat] 
[-inplace] [-noinplace] [-whatnowproc program] 

[-nowhatnowproc] [-digest list] [-issue number] 
[-volume number] [-help] 


inc - incorporate new mail 
Syntax 

inc [ + folder name) [-audit audit-file] [-noaudit] 

[-changecur] [-nochangecur] [-form formatfile] 
[-format string] [-file name] [-silent] [-nosilent] 
[-truncate] [- not run cate] [-width columns] [-help] 

mark - mark messages 
Syntax 

mark [+ folder name] [msgs] [-sequence name...] [-add] 
[-delete] [-list] [-public] [-nopublic] [-zero] [-nozero] 
[-help] 

mh - Message Handler 

mhl - produce formatted listings of MH 
messages 

Syntax 

/usr/new/lib'mh/mhl [-bell] [-nobell] [-clear] [-noclear] 
[-folder + folder name] [-form formfile] [-length lines] 
[-width columns] [-moreproc program] [-nomoreproc] 
[files ...] [-help] 
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mhmail - send or read mail 
Syntax 

mhmail [attars ...] [-body text] [-cc addrs 
[-from addr] [-subject subject] [-help] 


mhpath - print full pathnames of MH 
messages and folders 

Syntax 

mhpath [+ foldername] [msgs] [-help] 

msgchk - check for messages 
Syntax 

msgchk [-nodate] [-notify all/mail/nomail] lusers ...] 

[- help] 

msh - MH shell 
Syntax 

msh [-prompt string] [-scan] [-noscan] [-topcur] 
[-notopcur] [file] [-help] 

next - show the next message 
Syntax 

next [+ foldername] [-header] [-noheader] [-showproc 
program] [-noshowproc] [switches for showproc] [-help] 


1-60 Details of Selected Commands 







packf - compress a folder into a single 
file 

Syntax 

packf [+folder] [rasgs] [-file name] [-help] 


pick - select messages by content 
Syntax 

pick [+folder) [msgs] [-and ...] [-or ...] [-not ...] 
l-lbrace ... -rbrace] [-search] [—component pattern] 
[-after date) [-before date] [-datefield field] 

[-sequence name ...] [-public] [-nopublic] [-zero] 

[-nozero] [-list] [-nolist] [-help] 

prev - show the previous message 
Syntax 

prev [ + folder name] [-header] [-noheader] 

[-showproc program) [-noshowproc] [-switches for 
showproc] l-help] 

prompter - prompting editor front-end 
Syntax 

prompter [-erase chr) [-kill chr) [-prepend] [-noprepend] 
[-rapid] [-norapid] file [-help] 

rcvstore - incorporate new mail 
asynchronously 
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Syntax 

rcvstore [+ folder] l-create) [-nocreate] (-sequence name] 
[-public] (-nopublic] [-zero] [-nozero] [-help] 

refile - file message in other folders 
Syntax 

refile [msgs] [-draft] [-link] [-nolink] [-preserve) 

[-nopreserve] [-src + foldername] [-file filename] + folder 
[-help] 

repl - reply to a message 
Syntax 

repl [+ folder] [msg] [-annotate] [- noannotate] 

[— cc aWto/cc/me] [-nocc alUto/cc/me] 

[-draftfolder + foldername] [-draft message msg] 

[- nodraft folder] [-editor editor] [-noedit] 

[-fee + foldername] [-filter filterfile] [-form formfile] 
[-format] [-noformat] [-inplace] [-noinplace] [-query] 
[-noquery] [-width columns] [-whatnowproc program] 

|-nowhatnowproc] [-help] 

rmf - remove folder 
Syntax 

rmf [+ foldername] [-interactive] [-nointeractive] [-help] 

rmm - remove messages 
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Syntax 

rmm [+ folder) [msgs] [-help] 


scan - produce a one-line-per-message 
scan listing 

Syntax 

scan [ + folder] [msgs] [-clear] [-noclear] 

[-form format file] [-format string] [-header] [-noheader] 
I- width columns] [- help] 

send - send a message 
Syntax 

send [-alias aliasfile] [-draft] [-draftfolder + folder name] 
[-draft message msg] [-nodraft folder] [-filter filterfile] 

[-nofilter] [-format] [-noformat] [-forward] [-noforward] 
[-msgid] I-nomsgid] [-push] [-nopush] [-verbose] 
[-noverbose] [-watch] [-nowatch] [-width columns] 

[file ...] [-help] 

show - show (list) messages 
Syntax 

show [+ folder) [rnsgs] [-draft] [-header] [-noheader] 

[- showproc program] [-noshowproc] [switches for 
showproc] [-help] 

slocal - MH receive-mail hooks 


Details of Selected Commands 1-63 








Syntax 

slocal $HOME/.maildelivery [-form formfile] 
[switches for postproc] address ... [-help] 
/usr/new/lib/mh/rcvpack file [-help] 
/usr/new/lib/mh/rcvtty [command ...] [-help] 


sortm - sort messages 
Syntax 

sortm [+ folder] [msgs] [-datefield field] [-verbose] 
[-noverbose] [-help] 

whatnow - prompting front-end for send 
Syntax 

whatnow [- draft folder + folder] [-draft message msg] 

[-nodraftfolder] [-editor editorname] [-noedit] 

[-prompt string] [file] [-help] 

whom - report to whom a message 
would go 

Syntax 

whom [-alias alias file] [-check] [-nocheck] [-draft] 

[-draftfolder + folder] [-draft message msg] 

[- nodraftfolder] [file] [- help] 


1-64 Details of Selected Commands 







Other Section 1 Commands 2 


This section summarizes the remaining commands from 
Section 1 of the Reference Pages. 

2780e - spooler for the IBM 2780 
emulator 

Syntax 

2780e [-m] [-a] [-q] [-b] [-1] l-Sfile] l-Hnum] file... 
(-o file...} 


Options 


-# 

Waits for num files to be received 
as output from job and gives default 
file names in the form Ruseridpid. 

- a 

Send file as priority job. 

-b 

Transmits the file to an IBM 
system that accepts multiple record 
transmission. 

- m 

Notifies user by mail that file was 
sent and output was received. 

-0 

Name output files with specified file 
names. 

-q 

Prepares the file for transmission 
and places it in /usr/spool/rje but 




does not call 2780d to transmit. 

-S Sends contents of file to the IBM 

system as a sign-on card. 

-t Sends data in transparent mode. 

3780e - spooler for the IBM 3780 
emulator 

Syntax 

3780e [-C] |-m] [-a] [-q] [-t[b]] [-S/iZe] l-*num] file... 
[-o file] 


Options 


-# 

Waits for num files to be received 
as output from job and gives default 
file names in the form Ruseridpid. 

-a 

Send file as priority job. 

-b 

Transmits the file to an IBM 
system that accepts multiple record 
transmission. 

-C 

Prevents the compression of spaces 
when files are sent. 

- m 

Notifies user by mail that file was 
sent and output was received. 

-o 

Name output files with specified file 
names. 

-q 

Prepares the file for transmission 
and places it in /usr/spool/rje but 
does not call 2780d to transmit. 

-s 

Sends contents of file to the IBM 
system as a sign-on card. 

-t 

Sends data in transparent mode. 
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-tb 


Transmits the file to an IBM 
system that accepts multiple 80- 
column card records in transparent 
mode. 

addbib - create or extend 
bibliographic database 


Syntax 

addbib [-p promptfile] [-a] database 


Options 

-a Suppresses prompting for an 

abstract. 

-p Causes use of a new prompting 

skeleton, defined in promptfile. 

apply - apply a command to a 
set of arguments 

Syntax 

apply (-ac) [-n] command args... 

apropos - locate commands by 
keyword lookup 

Syntax 

apropos keyword... 

ar - archive and library maintainer 
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Syntax 

ar -key [ posname ] afile name... 


Options 

d Deletes the named files from the archive file. 

m Moves the named files to the end of the archive. 

p Prints the named files in the archive. 

q Appends the named files to the end of the 
archive file. 

r Replaces the named files in the archive file. 

t Prints a table of contents of the archive file. 

x Extracts the named files. 

a Tells the ar command that new files should be 
placed after posname. 

b Tells the ar command that new files should be 
placed before posname. 

c Suppresses the message that is normally produced 
when afile is created. 

i Tells the ar command that new files should be 
placed before posname. 

1 Places files in the local directory instead of the 
/tmp directory where they are normally placed. 

o Resets the last-modified date to the date recorded 
in the archive. 

u Replaces only those files with last-modified dates 
later than the archive files. 

v Gives a file-by-file description of the making of a 
new archive file from the old archive and the 
constituent files. 
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as - assembler 

Syntax 

as [-dl24] [-L] [-W] [-V] [-J] [-R] [-t directory) [-o 
objfile] [name...] 


Options 


-d 


Specifies number of bytes for offsets 
that involve forward or external 
references and have sizes unspecified 
in assembly language. 

-J 


Uses long branches to resolve jumps 
when byte-displacement branches are 
insufficient. 

-L 


Saves defined labels beginning with 

L, which are normally discarded. 

-0 


Specifies the name of the output 
file. 

-R 


Make initialized data segments read 
only, by concatenating them to the 
text segments. 

-t 


Specifies a directory other than the 
default /tmp to receive the 
temporary file. 

-V 


Uses virtual memory rather than a 
temporary file for immediate 
storage. 

-W 


Do not complain about errors. 

at, batch - 
a later time 

execute commands at 
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Syntax 

at time [day] [file] 
at -r job... 
at -1 [job] 
batch [file] 

Options 

- r Removes jobs previously scheduled 

by at or batch. 

_1 Used to obtain or verify the job 

numbers. 

awk - pattern scanning and 
processing language 

Syntax 

awk t-Fc] l-f prog] [-] [file...] 


Options 


. 

Used for standard input file. 

-Fc 

Sets interfield separator to named 
character. 

- f prog 

Uses prog file for patterns and 
actions. 


basename - strip directory names 
from pathname 

Syntax 

basename string [suffix] 
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be - interactive arithmetic 
language processor 

Syntax 

be [-c] [-1] [file...] 


Options 

-c Compiles input only. 

-1 Names arbitrary precision math 

library. 

bdiff - big file differential 
comparator 

Syntax 

bdiff filel file2 In] [- s] 

Options 


Suppresses normal diagnostic 
messages. 


biff - be notified if mail arrives 
and who it is from 

Syntax 

biff [yn] 

Options 

- n Disables notification that mail has 

arrived. 
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_y Enables notification that mail has 

arrived. 

binmail - send or receive mail 
among users 

Syntax 

/bin/mail [+] [-i] [ person ... ] 

/bin/mail [+] [— i] -f file 

Options 

Displays mail messages contained in 
the specified file (next argument) in 
place of your mailbox file. 

_ j Notifies mail to continue after 

interrupts. 

cal - print calendar 

Syntax 

cal [ month) year 

calendar - calendar reminder 
service 

Syntax 

calendar [ - ] 

Options 

Functions for every user who has a 
calendar file in his login directory. 
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capsar - prepares a DOTS or DDIF 
document for transport in the Mail 
system 


Syntax 

capsar [-c] [-t] [-x[hTD]J [filename] 


Options 

- C 

-t 

-xh 


-xT 


-xD 


Create an encapsulated DOTS 
bodypart from filename. 

Write the message type of filename 
to standard output. 

Extract mail header lines from 
filename. 

Extract all text parts of filename to 
standard output. 

Extract all DOTS bodyparts from 
filename. 


cat - concatenate and print data 

Syntax 

cat [-6] l-e) [-n] [- s] [-t] [-a] [-i>] file... 

Options 

-b Ignores blank lines and precedes 

each output line with its line 
number. 

” e Displays a dollar sign ($) at the 

end of each output line. 

“ n Precedes all outputlines (including 

blank lines) with line numbers. 
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-s Squeezes adjacent blank lines from 

output and single spaces output. 

-t Displays non-printing characters 

(including tabs) in output. 

-u Unbuffers output. 

-v Displays non-printing characters 

(excluding tabs). 

cb - C program beautifier 

Syntax 

cb 

cc - C compiler 

Syntax 

cc [ option... ] file... 


Options 

-f Specifies that computations involving only 

FFLOAT numbers be done in single precision and 
not promoted to double. 

- g Directs the compiler to produce additional symbol 
table information for dbx(l). 

-O Uses the object code optimizer. 

cd - change current directory 

Syntax 

cd directory 


2-10 Other Section 1 Commands 




cdoc - Compound document 
converter 

Syntax 

cdoc [ -s format ] [ -d format ] [ -O file ] [ -o 
outputfile ] inputfile 

Options 

-s Specifies the format of the input (source) file. 

- d Specifies the format of the output (destination) 
file. 

-0 Names a file that contains the processing options 
to be applied during conversion. 

-o Specifies the name of the output file. 

cflow - generate C flow graph 

Syntax 


cflow t-r] [-ix] 

[- i- 1 [-d/iam] files 

Options 


-d 

The num 
which the 

decimal integer indicates the depth at 
flow graph is cut off. 

-i_ 

Includes names that begin with an underscore. 

-ix 


Includes external and static data 
symbols. 

- r 


Reverse the "callerrcallee" 


relationship producing an inverted 
listing showing the callers of each 
function. 
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checknr - check nroff/troff files 


Syntax 

checknr [— s] [-f] [-axl.yl.x2.y2.xn.yn] 

[-c.xl.x2.x3... .xn] [file...] 


Options 


-a 

Allows additional pairs of macros to 
be added to the list. 

-c 

Defines commands otherwise 
complained about as undefined. 

-f 

Ignores \f font changes. 

-s 

Ignores \s font changes. 

chfn - 

change system finger entry 

Syntax 



chfn [ loginname 


chgrp - 

- change file group 

Syntax 



chgrp [— f ] group file. 


Options 


-f 

Reports only system and usage 
messages. 
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chmod - change file mode 

Syntax 

chmod mode file... 

chsh - change login shell 

Syntax 

chsh name [shell] 

clear - clear terminal screen 

Syntax 

clear 

cmp - compare file data 

Syntax 

cmp [-1] [-s] filel file2 

Options 

-1 Long format: byte where difference occurs 
(decimal) and data differences (octal). 

-s Suppresses normal output and displays return code 
only. 

col - filter reverse line feeds 
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Syntax 

col [-options] 


Options 

-b Assumes that the output device does not have 
backspacing. 

-f Suppresses moving half lines to the next full 
line. 

-h Suppresses conversion of white space to tabs. 

-p Forces through unchanged any unknown escape 
sequences that are found in its input. 

-x Suppresses conversion of white space to tabs 
(same as -h). 

colcrt - filter nroff output for CRT 
previewing 

Syntax 

colcrt [-] [-2] [ file ... ] 


Options 

Suppresses all underlining. 

-2 Causes half-lines to be printed, double spacing the 
output. 

colrm - remove columns from a 
file 

Syntax 

colrm [ startcollendcol]] 
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comm - compare sorted data 


Syntax 

comm [-[123]] filel file2 

Options 

1 Suppresses column one: lines in filel only. 

2 Suppresses column two: lines in file2 only. 

3 Suppresses column three: lines in filel and file2. 

compact, uncompact, ccat - 
compress and uncompress files, 
and cat them 

Syntax 

compact [name...] 
uncompact [ name... ] 
ccat [file... ] 

compress, uncompress, zcat - 
compress and expand data 

Syntax 

compress [ - f ) [ -v ] [ -c ] [ -b bits ] [ name ... ] 
uncompress [ - f ] [ - v ] [ - c ] [ name 
... ] 

zcat [ name ... ] 

Options 

Forces compression of name. 

” c Makes compress/uncompress write to 

standard output. 
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Specifies the allowable bits limit. 

_ v Displays the percent reduction of 

each file. 

cp - copy file data 

Syntax 

cp [-1] l-r] filel file2 

cp [-i] [— r] file... directory 

Options 

_ j Prompts user with the name of file 

whenever the copy will cause an old 
file to be overwritten. 

_ r Copies only to directories. 

cpio - copy file archives in and 
out 

Syntax 

cpio -o [fceys] 

cpio -i [keys] [patterns] 
cpio - p [ keys 1 directory 


Options 


-i 

Copies files that match the specified 


pattern. 

-0 

Copies out the specified files. 

-p 

Copies file into the specified 


directory. 
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cpp - the C language 
preprocessor 


Syntax 

/lib/cpp [ option . 

.. ] [ ifile [ ofile ] ] 

Options 


-B 

Strips C-l- + -style comments (begin 
with II and end with newline). 

-c 

Passes along all comments, except 
those found on cpp directive lines. 

- M 

Generates dependency lists suitable 
for use with make( 1) instead of the 
normal output. 

-P 

Preprocesses the input without 
producing the line control 
information used by the next pass 
of the C compiler. 

-R 

Permits recursion when a macro is 
expanded. 

- Mnarne 

Removes any initial definition of 
name where name is a reserved 
symbol that is predefined by the 
preprocessor. 

- D name 


- Dname= def 

Defines name as if by a ^define 
directive. 

-1 dir 

Changes the algorithm for searching 
for #include files whose names do 
not begin with a backslash ( \) to 
look in dir before looking in the 
directories on the standard list. 
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csplit - context split 

Syntax 

csplit [ -s ] [ -k ] [ -f prefix ) file argl [ ...argn ] 

Options 


- s 

Suppresses the printing of all 
character counts. 

-k 

Leaves previously created files 
intact. 

- fprefix 

Names the created files 
prefixOO...prefixn. 

ctags - 

create a tags file 

Syntax 

ctags [ options] name... 

Options 

-a 

Appends information to an existing 
tags file. 

-B 

Uses backward search patterns. 

-F 

Uses forward search patterns. 

-t 

Creates typedef tags. 

-u 

Updates the specified tags file. 

- V 

Generates an index listing function 
name, file name, and page number. 

- w 

Suppresses warning diagnostics and 
generates a listing. 
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ctod - combine DDIS objects into 
DOTS format 

Syntax 

ctod [ -x ] object.ddis 


Options 

-x Specifies that ctod is to DOTS 

encode the input file without 
resolving any external references 
present in the file. 

ctrace - C program debugger 

Syntax 

ctrace [options] [file] 
etc (options ] [ file ] 
ctcr [options] [file] 

Options 

-f functions Trace only these functions. 

-v functions Trace all but these functions. 

cut - cut out selected fields of 
each line of a file 

Syntax 

cut -c list [filel file2...] 

cut -f list [-dc/iar] [— s] [filel file2...] 
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Options 


list 

Specifies ranges that must be a 
comma-separated list of integer field 
numbers in increasing order. 

- c list 

Specifies character positions to be 
cut out. 

- (list 

Speficies the fields to be cut out. 

- d char 

Uses the specified character as the 
field delimiter. 

- s 

Supresses lines with no delimiter 
characters. 

cxref - generate C program cross 
reference 

Syntax 


cxref [options] files 

Options 


-C 

Prints a combined cross-reference of 
all input files. 

- D name 

Defines name to processor, as if by 
Ndefine. 

-1 dir 

Searches named directory for 
#include files whose names do not 
begin with a backslash ( \). 

-Lt 

Abbreviation for library name 
/lib/libx.a where x is a string. 

-o file 

Directs output to named file. 

-s 

Operates silently; does not print 
input file names. 
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-t Formats listing for 80-column width. 

-U name Removes any initial definition of 

name. 

w<num> Width option which formats output 

no wider than columns (decimal). 

date - print date and time 

Syntax 

date [[yy[mm[dd])]hhmm[.ss][-[-]tttt][z]] [ + format ] 

Options 

n Insert a new-line character 

t Insert a tab character 

m Month of year - 01 to 12 

d Day of month - 01 to 31 

y Last 2 digits of year - 00 to 99 

D Date as mm/dd/yy 

H Hour - 00 to 23 

M Minute - 00 to 59 

S Second - 00 to 59 

T Time as HH:MM:SS 

u Displays time in Greenwich Mean Time 

j Day of year - 001 to 366 

w Day of week - Sunday = 0 
a Abbreviated weekday - Sun to Sat 
h Abbreviated month - Jan to Dec 
r Time in AM/PM notation 


Other Section 1 Commands 2-21 







dc - desktop calculator 

Syntax 

dc [file] 

dd - copy and convert data 


Syntax 

dd [option = 

= value... ] 

Options 


if= name 

Input file name. 

of= name 

ibs= n 

Output file name. 

Input block size, n bytes. 

obs= n 

Output block size, n bytes. 

bs= n 

Set both input and output block 
size to n bytes, superseding ibs and 
obs. 

cbs= n 

Conversion buffer size, n bytes. 

skip= n 

Skip n input records before starting 
to copy. 

files = n 

Copy n input files before 
terminating. 

seek= n 

Seek n records from beginning of 
output file before copying. 

rbuf= n 

Use n buffers for reading from 
those raw devices that support n- 
buffered I/O. 

wbuf= n 

Use n buffers for writing from those 
raw devices that support n-buffered 
I/O. 
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count = n 

Copy only n input records. 

conv= ascii 

Convert EBCDIC to ASCII. 

conv= ebcdic 

conv= ibm 

Convert ASCII to EBCDIC. 

Slightly different map of ASCII to 
EBCDIC (see RESTRICTIONS). 

conv= block 

Convert variable length records to 
fixed length. 

conv= unblock 

Convert fixed length records to 
variable length. 

conv= lease 

Map alphabetics to lower case. 

conv= ucase 

Map alphabetics to upper case. 

conv= swab 

Swap every pair of bytes. 

conv= noerror 

Do not stop processing on an error. 

conv= sync 

conv = nomult i 

Pad every input record to ibs . 
Disable multiple tape volumes. 

conv=... 



deroff - remove formatting codes 
from text 


Syntax 

deroff [-w] file... 


Options 


- W 

Generates word list (one word per 
line). 


df - display free and used disk 
space 
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Syntax 

df [— i] [— n] [filesystem...] [file...] 


Options 

_i Also report the number of used and 

free inodes. 

_n Do not update the file system 

statistics stored in memory. 

dgate - log in to a DECnet remote 
system through an intermediate 
ULTRIX DECnet host (gateway 
system) 

Syntax 

dgate host 


Syntax 

diction [-ml] [-mm] [-n] [-f pfile] file... 
explain 

Options 

-mm 

-ml 
-ip file 


Overrides default macro package 
- ms. 

Causes deroff to skip lists. 

Specifies pattern file in addition to 
default file or, default file can be 
suppressed with - n flag. 


diction,explain - print 
sentences; thesaurus 


wordy 
for diction 
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diff - differential file comparator 


Syntax 

diff (-11 [- r] t- s] [- cefh] [-b] dirl dir2 
diff [-cefh] [-b] filel file2 
diff [- D string] [-b] filel file2 


Options 


-l 

Displays output in long format. 

- r 

Recursively checks files in common 
subdirectories. 

- s 

Displays names of files that are the 
same. 

- S name 

Beginning with the specified file 
starts a directory in the middle. 

-e 

-f 

Writes output to an ed script. 

Writes output in reverse order to a 
script. 

-c n 

Displays specified number of context 
lines with each output line. 

-h 

-D string 

Makes a hasty comparison. 

Causes diff to create a merged 
version of filel and file2 on the 
standard output. 

-b 

Ignores trailing blanks and other 
strings of blanks to compare equal. 


diff3 - 3-way differential file 
comparison 
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Syntax 

diff3 [- ex3] filel fiU2 file3 


Options 


-3 

Produces an ed editor script 
containing the changes between filel 
and file2 that are to be incorporated 
into file3. 

-e 

Produces an ed editor script 
containing the changes between file2 
and file3 that are to be incorporated 
into filel. 

-X 

Produces an ed editor script 
containing the changes among all 
three files. 

diffmk - 
files 

mark differences between 

Syntax 



diffmk namel name2 name3 


dircmp 

- directory comparison 

Syntax 



dircmp [ -d ] [ -s ] [ -w n ] dir.. 


Options 


-d 

Compares the contents of files with 
the same name in both directories 
and output a list telling what must 
be changed in the two files to bring 
them into agreement. 
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_s Suppresses messages about identical 

files. 

“ wn Changes the width of the output 

line to n characters. 

?rom pIthname Ver direC,0ry names 

Syntax 

dirname string 


- display or set the 
n?.m e of . the current domain for 
this system 


Syntax 

domainname (nameofdomain ] 


DOTS"file npaCk objects from a 


Syntax 

dtoc [[ object.dots ] directory ] 

du - print amount of disk usage 

Syntax 

du [-s] [-a] f name ... ] 
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Options 


Displays the disk usage for each 
file. 

Displays a summary total only. 


- a 


echo - echo arguments 

Syntax 

echo [— n] [arg...] 

Options 

-n Suppresses newlines from output. 

echo - echo arguments 

Syntax 

echo [ arg ] ... 

error - analyze and disperse 
compiler error messages 

Syntax 

error [- n] hs] [-q] [-v] [-t suffixlist) [-1 ignore file] 

[ name ] 

Options 

- I ignorefile Ignore the functions listed in the 

specified file (next argument). 

-n Does not touch files and sends error 

messages to the standard output. 
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-q 

Prompts before touching the source 
file. 

-s 

Shows error in unsorted order from 
the error file. 

-s 

Displays statistics for each error 
type. 

-T 

Terse output. 

- t suffix list 

Does not touch those files that 
match the specified suffix. 

-V 

Invokes the vi editor on each file 
that had been touched. 

expand, unexpand - expand tabs 
to spaces, and vice versa 

Syntax 


expand [-faisfop] [-fafcn... ] [ file ... ] 
unexpand [-a] ( file ... ] 

Options 


-0 

Sets tabstops the specified number 
of spaces (#) apart. 

- a 

When used with unexpand, 
compresses file by inserting tabs for 
two or more spaces. 


expr - evaluate expressions 

Syntax 

expr arg... 
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extract - interactive string extract 
and replace 

Syntax 

extract [ -i ignore file ] [ -m prefix ] [ -n ] [ -p 
patternfile ] [ -s string } 

[ -u ] filelist 

Options 

_i Specifies a new ignore file to be used to 

instruct extract to ignore specific text 
strings. 

_ m Specifies a prefix to message numbers in 

the nl_ file and in the file. 

_ n Create a new message source file for 

each input file. 

_p Specifies a new pattern file to be used. 

_ s Specifies a string to be output at the 

start of the file. 

_ u Use a message file produced by a 

previous run of strextract. 

eyacc - modified yacc allowing 
much improved error recovery 

Syntax 

eyacc [— v] [grammar] 

file - determine file type 
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Syntax 

file [ -c ] [ -f ffile] [ -m mfile] filename 


Options 


-C 

Checks the magic file for format 
errors by printing the internal 
representation of the magic file. 

-f 

Interprets the following argument to 
be a file containing the names of 
the files to be examined. 

-m 

Instructs file to use an alternate 
magic file. 


find - find files 

Syntax 

find pathname-list expression 


Options 


- atime n 

Tests true if the file has been 
accessed in n days. 

-cpio device 

Writes current file on device in 
cpio(5) format (5120-byte records). 

-exec command 

Tests true if specified command 
returns a 0 on exit. 

-group gname 

Tests true if group ID matches 
specified group name. 

-inum n 

Tests true if the file has inode 
number n. 

-links n 

Tests true if the file has n links. 

-mount 

Tests true if the current file is on 
the same file system as the current 
starting pathname. 
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- mtime n 
-name filename 
-newer file 

-ok command 

-perm onum 

-print 
-size n 

-type c 


-user uname 


Tests true if the file has been 
modified in n days. 

Tests true if the filename argument 
matches the current file name. 

Tests true if the current file has 
been modified more recently than 
the argument file. 

Executes specified command on 
standard output, then standard input 
is read and command executed only 
upon response y. 

Tests true if file has specified octal 
number. 

Prints current pathname. 

Tests true if the file is n blocks 
long (512 bytes per block). 

Tests true if file is c type ( c = b, 
block special file: c, character special 
file: d, directory: f, plain file: 1, 
symbolic link: p, type port: s, type 
socket). 

Tests true if file owner is login 
name or numeric user ID. 


finger - print user finger 
information 


Syntax 

finger [ options ] [name...] 
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Options 

-b 

Displays a briefer long form list of 
users. 

-f 

Disables printing of headers for 
short and quick outputs. 

-h 

Suppresses printing of the .project 
file. 

-i 

Displays list of users with idle 
times. 

-1 

Displays output in long format. 

- m 

Matches arguments only on user 
name. 

-P 

Suppresses printing of the .plan file. 

-q 

Displays list of users. 

- s 

Displays output in short format. 

- w 

Displays narrow short format of 
specified users. 

fmt - 

simple text formatter 

Syntax 

fmt [name... ] 

fold - 

fold long lines for finite 

width 

output device 

Syntax 

fold [-width] [ file...] 
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from - identifies sender of mail 

Syntax 

from [-f mailbox ] l-s sender ] 


Options 

- f mailbox 

Uses specified file instead of your 
normal mail file. 

-s sender 

Prints mail headers for mail sent by 
specified sender. 


fsolit - split a multi-routine Fortran 
file into individual files 

Syntax 

fsplit [-e efile...] [file] 


Options 


- e efile 

Splits only specified subprogram 
units into separate files. 


ftp - file transfer program 

Syntax 

ftp [-v] [-d] [-i] t-n] [-gl [host] 


Options 


-d 

Enables debugging. 

-g 

-i 

Disables file name expansion. 

Disables interactive prompting during 
multiple file transfers. 
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Disables autologin during an initial 
connection. 

Displays all responses from the 
remote server as well as all data 
transfer statistics. 


gcore - get core images of 
running processes 

Syntax 

gcore process-id... 


gencat - generate a formatted 
message catalog 

Syntax 

gencat [ -h hdrfile ] catfile msgfile .... 

Options 

-h Causes gencat to generate a header 

file suitable for inclusion in the 
program source via a ^include. 

getopt - parse command options 


Syntax 

set -- getopt optstring $*' 



display call graph profile 
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Syntax 

gprof [ options ] [ a.out [gmon.out... ] ] 


Options 


-a 

Suppresses the printing of statically 
declared functions. 

-b 

Suppresses the printing of a 
description of each field in the 
profile. 

-c 

The static call graph of the program 
is discovered by a heuristic which 
examines the text space of the 
object file. 

- E name 

Suppresses the printing of the graph 
profile entry for routine name (and 
its descendants) as -e, above, and 
also excludes the time spent in 
name (and its descendants) from 
the total and percentage time 
computations. 

- e name 

Suppresses the printing of the graph 
profile entry for routine name and 
all its descendants More than one 
-e option may be given. 

- F name 

Prints the graph profile entry of 
only the routine name and its 
descendants (as -f, above) and also 
uses only the times of the printed 
routines in total time and 
percentage computations. 

- f name 

Prints the graph profile entry of 
only the specified routine name and 
its descendants. 

-s 

Produces a profile file gmon.sum is 
produced which represents the sum 
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-2 

graph - 
Syntax 

graph [option.. 

Options 

- a 

-b 

-c 

-g 

-h 

-1 

- m 


of the profile information in all the 
specified profile files. 

Displays routines which have zero 
usage (as indicated by call counts 
and accumulated time). 

draw a graph 


.] 


Supplies abscissas automatically and 
uses next two arguments to set 
spacing and starting point. 

Breaks graph after each label in the 
input. 

Uses specified string (next 
argument) as label. 

Uses specified number (next 
argument) in setting up grid style: 

0 (no grid), 1 (frame with ticks), 
and 2 (full grid). 

Uses specified number (next 
argument) as fraction of space for 
height. 

Uses specified string (next 
argument) as graph label. 

Uses specified number (next 
argument) in setting up line mode: 

0 (disconnected) and 1 (connected). 

Uses specified number (next 
argument) as fraction of space to 
right before plotting. 
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- s 

Saves screen (no erase) before 
plotting. 

-t 

Transposes vertical and horizontal 
axes. 

- u 

Uses specified number (next 
argument) as fraction of space to 
move up before plotting. 

- w 

Uses specified number (next 
argument) as fraction of space for 
width. 

-X [ 1 ] 

Determines x axis logarithmically. 

-y [ 1 1 

Same as x but for y axis. 


grep, egrep, fgrep - search file 
for regular expression 


Syntax 

grep [option...] expression [file...] 
egrep [option...] [expression] [file...] 
fgrep [option...] [springs] [file] 


Options 

-b 


- c 


- e expression 

- f file 
-i 


Precedes each output line with its 
block number. 

Produces count of matching lines 
only. 

Uses next argument as expression 
that begins with a minus (-). 

Takes regular expression (egrep) or 
string list (fgrep) from file. 

Considers upper and lowercase letter 
identical in making comparisons 
(grep and fgrep only). 
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Lists files with matching lines only 
once, separated by a new line. 

“ n Precedes each matching line with its 

line number. 

~ s Silent mode and nothing is printed 

(except error messages). 

’ v Displays all lines that do not match 

specified expression. 

“ w Searches for an expression as for a 

word (as if surrounded by ‘ \<’ and 

" x Prints exact lines matched in their 

entirety (fgrep only). 

groups - show group memberships 

Syntax 

groups laser] 


head - give first few lines 

Syntax 

head [-count] [file...] 


hostid - set or print identifier of 
current host system 


Syntax 

hostid [ identifier ] 
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hostname - print system name 

Syntax 

hostname [ nameofhost ] 

ic - compiler for language support 
database 

Syntax 

ic [ -Dname=def ) [ -U name ] [ I dir ] [ -v ] [ -o 
output ) [ source ] 

Options 

-D Defines name to the C preprocessor, as if #define 
name had been typed at the head of a source file. 

-U Removes any initial preprocessor definition of 
name. 

-I Searches for include files in the named directory, 
-o Names the ic output file output. 

-v Gives statistics on the number of simple and 

double letters, the number of tables in the source 
and the size of the generated binary file. 

id - print user and group IDs and 
names 

Syntax 

id 
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indent - 
program 


indent and format 
source 


C 


Syntax 

indent input [output] [flags] 


Options 


-1 nnn 

Determines maximum length of 
output line. 

- cnnn 

Determines column in which 
comments start. 

-cdnnn 

Determines column in which 
comments on declarations start. 

- i nnn 

Determines number of spaces for 
one indentation level. 

T? 

a 

i 

$ 

i 

Causes declarations to be left 
justified. 

- v,- nv 

-v turns on “verbose” mode, -nv 
turns it off. 

- be,- nbc 

Forces newline after each comma in 
a declaration. 

- dnnn 

Controls the placement of comments 
which are not to the right of code. 

- br,- bl 

Specifying -bl causes complex 
statements to be lined up in a 
space order. 


install - install binaries 

Syntax 

install [— c) [-m mode] [-o owner] [-g group] [-s] 
binary destination 
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Options 


-C 

Moves or copies binary to 
destination. 

- g group 

Specifies a different group from 
group staff for destination. 

- m mode 

Specifies a different mode from the 
standard 755 for destination. 

- o owner 

Specifies a different owner from 
owner root for destination. 

-s 

Strips the binary after it is 
installed. 

iostat - 

report I/O statistics 


Syntax 

iostat [ interval[count]] 

ipcrm - remove a message queue, 
semaphore set 


Syntax 

ipcrm [options] 


Options 

-q msqid 


-m shmid 


-s semid 


Removes the message queue 
identifier msqid from the system 
and destroys the message queue and 
data structure associated with it. 

Removes the shared memory 
identifier shmid from the system. 

Removes the semaphore identifier 
semid from the system and destroys 
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-Q msgkey 

the set of semaphores and data 
structure associated with it. 

Removes the message queue 
identifier, created with key msgkey , 
from the system and destroys the 
message queue and data structure 
associated with it. 

-M shmkey 

Removes the shared memory 
identifier, created with key shmkey , 
from the system. 

-S semkey 

Removes the semaphore identifier, 
created with key semkey , from the 
system and destroys the set of 
semaphores and data structure 
associated with it. 


ipcs - report interprocess 
communication facilities status 


Syntax 

ipcs ( options ] 


Options 


-m 

Displays information about active 
shared memory segments. 

-q 

Displays information about active 
message queues. 

- s 

Displays information about active 
semaphores. 

- a 

Uses all print options (shorthand 
notation for -b, -c, -o, -p and -t). 

-b 

Displays the biggest allowable size 
information. 
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Uses the specified core file (next 
argument) in place of /dev/kmem. 

Displays creator’s login name and 
group name. 

Uses the specified namelist (next 
argument) in place of /vmunix. 

Displays the outstanding usage 
information (number of messages 
in queue, size of each and number 
of processes attached to shared 
memory segments). 

Displays the process ID information. 
Displays all time statistics. 

The next 9 characters are 
interpreted as three sets of three 
bits each. 


join - join files 

Syntax 

join [options] filel file2 


Options 

_ Produces an additional line for 

unpaired lines from specified file n, 
where n is 1 or 2. 

_ e s Uses specified replacement string for 

all empty output fields. 

m Joins the mth field in the nth file. 

_ G Uses specified list for output line 

fields. 

_ tc Sets tab character. 
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kill - send a signal to a process 

Syntax 

kill [-«*£] processid... 

kill -1 

Options 

Lists signal names. 


last - indicate last 
and teletypes 


logins of users 


Syntax 

last [-N] [name...] [tty...] 


Options 

“ ^ Limits the number of output lines 

to the specified number. 


lastcomm - 
executed in 


show last commands 
reverse order 


Syntax 

lastcomm [command name...] [user name...] [terminal 
name... ] 


Id - link editor 

Syntax 

Id [option...] file... 
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Options 

The -T option may be used as well, and is 
taken to mean that the newly linked segment 
commences at the corresponding address (which 
must be a multiple of 1024). 

leave - remind you when you 
have to leave 

Syntax 

leave [ hhmm ] 

lex - generate lexical analyzer 

Syntax 

lex [-tvfn] [file...} 


Options 


-f 

Runs a faster compilation (does not 
pack resulting tables). 

- n 

Prints no summary information 
(default option). 

-t 

Writes to standard output instead of 
to file lex.yy.c. 

-V 

Prints one-line summary of 
generated statistics. 


line - read one line 
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Syntax 

line 

lint - check C code 

Syntax 

lint [- abchnpuvxYz] file... 

Options 

Report assignments of long values 
to int variables. 

Report break statements that cannot 
be reached. 

Complain about casts that have 
questionable portability. 

Apply a number of heuristic tests to 
attempt to find bugs, improve style, 
and reduce waste. 

Do not check compatibility against 
the standard library. 

Attempt to check portability to the 
IBM and GCOS dialects of C. 

Do not complain about functions 
and variables used and not defined, 
or defined and not used. 

Suppress complaints about unused 
arguments in functions. 

Report variables referred to be 
extern declarations, but never used. 

Compiles C programs for 
environment. 

Do not complain about structures 
that are never defined (for example, 
using a structure pointer without 
knowing its contents.) 
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-a 

-b 

-c 

-h 

-n 

-P 

- u 

-V 

-X 

- Y environment 

-Z 




Ik - link editor 

Syntax 

lk [ option ... ] file... 


Options 


- D number 

- e symbol 

Sets data segment length. 

Take the argument as the name of 
the entry point of the loaded 
program. 

- H number 

Takes number argument as a 
decimal integer, adds it to end of 
text, and starts data section at a 
higher address. 

-K 

Produces full load map, cross- 
referencing all defined symbols. 

-L dir 

Add dir to the list of directories in 
which libraries are searched for. 

-be 

Abbreviation for the library name 
where x is a string. 

-M 

Produces full load map, consisting of 
a module and program section 
synopsis and symbol cross-reference. 

-N 

Do not make text portion read only 
or sharable. 

-n 

Arranges (by giving the output file 
a 0410 “magic number”) that when 
the output file is executed, the text 
portion is read-only and shared 
anlong all users executing the file. 
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- o name 

Takes the name argument after -o 
as the name of the Ik output file, 
instead of a.out. 

-S 

Strips the output by removing all 
symbols except locals and globals. 

-s 

Removes the symbol table and 
relocation bits to save space. 

- T number 

Takes the argument as a 
hexadecimal number which sets the 
text segment origin. 

-t 

Displays the name of each file as it 
is processed. 

- u symbol 

Enters argument as undefined 
symbol in symbol table. 

-X 

Saves local symbols except for those 
whose names begin with ‘L\ 

•X 

Suppresses saving nonglobal symbols 
in output symbol table; enters only 
external symbols. 

■ Y environment 

Adjust the magic number in the 
output file so that the program runs 
in the specified environment . 

ysym 

Indicates each file in which sym 
appears, its type and whether the 
file defines or references it. 

z 

Loads process on demand from the 
resulting executable file (413 
format) rather than preloaded. 
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In - link to a file 


Syntax 

In [-f ] [— s] namel [ name2] 

In [-f ] [-s] name ... directory 

Options 


-f 

Suppresses all but the usage 


message. 

-s 

Creates a symbolic link. 

lock - 

reserve a terminal 


Syntax 

lock 

login - log in to a system 

Syntax 

login [ username ] 

Options 

_ r Used by the remote login server, 

rlogindC 8c), to force login to enter 
into an initial connection protocol. 

-P <programname >Causes login to set it’s standard 

input and output to be connected to 
the prompting program 
<programname >. 

-C string Allows the system to specify a 

command to be run using the user’s 
shell. 
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logname - get login name 

Syntax 

logname 


look - find lines in sorted data 

Syntax 

look [-df] string [file] 


Options 

“d Uses dictionary order: only letters, 

digits, tabs and blanks can be 
compared. 

Folds uppercase to lowercase 
(compares equally). 

jndxbib, lookbib - build inverted 
index for a bibliography, lookup 
bibliographic references r 

Syntax 

indxbib database... 
lookbib database 

■order - determine relation for an 
object library 


Syntax 

lorder file... 


Other Section 1 Commands 2-51 






Id - send requests to an LP line 
printer 


Syntax 

lp [— cl [-d dest] [-n number] [-] [files] 


Options 


-C 

Makes copies of the files to be 
printed immediately when Ip is 
invoked. 

-d dest 

Chooses dest as the printer that is 
to do the printing. 

-n number 

Prints number copies (default of 1) 
of the output. 


Ipq - spool queue examination 
program 

Syntax 

lpq [+ [n]] [-1] (- Pprinter] [job »...] [user...] 


Options 


+ n 

-1 

-P 

Displays spool queue. 

Displays information in long format. 

Displays information for the 
specified printer. 


Ipr - off line print 
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b- r 




Syntax 

lpr ( option... ] 

Options 

-p 
-l 

-t 

-n 

-d 

-g 

-v 

-c 

-f 

-X 

-r 


I file... ] 


Use pKl) to format the files 
(equivalent to print). 

Use a filter which allows control 
characters to be printed and 
suppresses page breaks. 

The files are assumed to contain 
data from troff( 1) (cat 
phototypesetter commands). 

The files are assumed to contain 
data from ditroff (device 
independent troff ). 

The files are assumed to contain 
data from TeX (DVI format from 
Stanford). 

The files are assumed to contain 
standard plot data as produced by 
the plot(3x) routines (see also 
plot(lg) ) for the filters used by 
the printer spooler). 

The files are assumed to contain a 
raster image for devices. 

The files are assumed to contain 
data produced by cifplot. 

Use a filter which interprets the 
first character of each line as a 
standard FORTRAN carriage control 
character. 

Transparent filter. 

Remove the file upon completion of 
spooling or upon completion of 
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printing (with the -s option). 

- m 

Send mail upon completion. 

-h 

Suppress the printing of the burst 
page. 

-P 

Use to direct output to a specific 
printer 

-C 

The argument is the job 
classification for use on the burst 
page. 

-J 

The argument is the job name to 
print on the burst page. 

-T 

The argument is the title used by 
pr( 1) instead of the file name. 

- Hnum 

Produces multiple copies of output. 

-i 

Causes the output to be indented 
the specified number of blank 
spaces. 

- w 

Takes the immediately following 
number to be the page width for pr. 

-z 

Takes the immediately following 
number to be the page length for 
pr. 

-s 

Uses symlink(2) to link data files 
rather than trying to copy them. 

-1234 

Specifies a font to be mounted on 
font position i. 


Iprm - remove jobs from line 
printer queue 
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Syntax 

lprm [-P printer] [-] (/oft #...] [user...] 

Options 

Removes all jobs owned by you 
only. 

- P printer Removes jobs from specified printer. 

Is - list and generate statistics for 
files 

Syntax 

Is [options] name... 


Options 

Displays one entry per line. 

” a Displays all entries including those 

beginning with a period (.). 

Forces multicolumn output for pipe 
or filter. 

~ c Sorts entries by time of 

modification. 

“ d Displays names of directories only, 

not contents. 

" F Marks directories with trailing slash 

(/), sockets with a trailing equal 
sign ( =), symbolic links with a 
trailing at sign (@), and executable 
files with a trailing asterisk (*). 

Displays names in the order they 
exist in directory. 
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g Displays assigned group ID (used 

with -1 only). 

i Displays the i-number for each file 

in the first column of the report. 

L Lists the information, if the file is 

a symbolic link, for the file or 
directory the link references rather 
than that for the link itself. 

1 Lists the mode, number of links, 

owner, size in bytes, and time of 
last modification for each file. 

The mode field consists of 11 
characters. 

d if the entry is a directory 

b if the entry is a block-type special 

file 

c if the entry is a character-type 
special file 

1 if the entry is a symbolic link 

s if the entry is a socket 

- if the entry is a plain file 

The next 9 characters are 
interpreted as three sets of three 
characters each. 

r if the file is readable 
w if the file is writable 
x if the file is executable 

- if the indicated permission is not 
granted. 

The group-execute permission 
character is given as s if the file 
has the set-group-id bit set; likewise, 
the user-execute permission 
character is given as s if the file 
has the set-user-id bit set. 
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The last character of the mode 
(normally ‘x’ or ‘-’) is t if the 
1000 bit of the mode is on. 

Forces the printing of nongraphic 
characters in file names as the 
question mark character (?). 

Recursively lists all subdirectories. 

“ r Sorts entries in reverse alphabetic 

or time order. 

” s Displays the size in kilobytes of 

each file. 

“t Sorts by time modified (latest first) 

instead of by name. 

" u Uses the time of last access instead 

of last modification for sorting (with 
the -t option) or printing (with the 
-1 option). 


Itf - labeled tape facility 


Syntax 

ltf option[ keys ] file... 

Options 

-c Creates a new volume assigning an interchange 
file name to the files on the volume. 

-H Displays help messages for all options and keys, 
-t Lists each named file on the specified volume. 

-x Extracts each named file from the volume to the 
user’s current directory. 
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m4 - macro processor 


Syntax 

m4 l files] 

make - maintain program groups 

Syntax 

make [-f makefile} [option...] [name...] 

Options 

_f Uses specified file as input. 

_j Equals an .IGNORE: entry. 

Stops processing current entry on 

nonzero return, but continues with 
other branches that do not depend 
on that entry. 

_ n Traces, prints, but does not update 

programs. 

_ r Equals an initial .SUFFIXES: entry 

with no list. 

_ s Equals a .SILENT: entry. 

Touches (updates) modification date 
of each target program only. 

man - displays manual pages 
online 

Syntax 

man -k keyword... 

man -f page^title... 

man [-] [— t] [-s] [1...8] page^title... 
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Options 

-k Display one line summaries of each 

reference page that contains the 
specified keyword or keywords. 

-f Display one line summaries of each 

page title specified on the command 
line. 

Squeeze multiple blank lines from 
output. 

-s Remove unnecessary blank lines. 

-t Phototypesets output using troff. 

mdtar - multivolume archiver 

Syntax 

mdtar [key] [ name ... ] 

Options 

-C Changes directory to specified name. 

c Creates a new archive. 

r Writes the named files to the end 

of the archive. 

t If no file argument is given, all 

Generates archive table of contents. 

u Updates the current archive. 

x Extracts each specified file from the 

archive. 

0...9 Selects unit number of the drive as 

an alternate disk drive. 

A Uses the specified number (next 

argument) as archive with which to 
begin the output. 
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b 

B 

f 

F[F] 

h 

i 

1 


m 

o 

P 


v 


w 


Uses the specified number (next 
argument) as the blocking factor. 

Forces output blocking to 20 blocks 
per record. 

Uses the specified file (next 
argument) as the name of the 
archive. 

Operates in fast mode. 

Saves a copy of the file (excludes 
symbolic links). 

Ignores checksum errors found in 
the archive. 

Displays an error message if all 
links to the files dumped cannot be 
resolved. 

Does not restore file modification 
times. 

Suppresses the normal directory 
information. 

Restores the named flies to their 
original modes, ignoring the present 
umask( 2). 

Uses specified number (next 
argument) as size of media in 512- 
byte blocks. 

Displays detailed (verbose) 
information as it archives files. 

Displays action to be taken for each 
file and prompts for confirmation. 


mesg - allow or disallow 
messages 
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Syntax 

mesg [n] [y] 

mkdir - make a new directory 

Syntax 

mkdir dirname... 

mkstr - create an error message 
file 

Syntax 

mkstr [-] messagefile prefix file... 

Options 

Places error messages at the end of specified 
message file. 

more, page - display file data at 
your terminal 

Syntax 

more [-cdflsu] [-n] [+ line number] [+/pattern] [ name ... ] 
page more options 

Options 

+ linenumber Start up at linenumber. 

+/pattern Start up two lines before the line 

containing the regular expression 
pattern. 
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-c 

Begins each page at the top of the 
screen and erases each line just 
before it draws on it. 

-d 

Displays extended continuation 
prompt at end of each display. 

-f 

Counts logical text lines (does not 
fold long lines). 

-1 

Ignores line feeds (CTRL/Ls) and 
normally, pauses at line feeds. 

- n 

Specifies number of line more 
displays. 

-s 

Squeezes multiple blank lines from 
the output, producing only one blank 
line. 

- u 

Ignores all underlining in the data. 

i <space > 

Display i more lines, (or another 
screenful if no argument is given) 

* D 

Display 11 more lines (a “scroll”). 

d 

Same as *D (control-D) 

i z 

Same as typing a space except that 
i, if present, becomes the new 
window size. 

is 

Skip i lines and print a screenful of 
lines 

if 

Skip i screenfuls and print a 
screenful of lines 

ib or i " B 

Skip back i screenfuls and print a 
screenful of lines 

q or Q 

Exit from more. 

— 

Display the current line number. 

V 

Start up the editor vi at the current 
line. 
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h or ? 

Help command; give a description of 
all the more commands. 

i/ex pr 

Search for the i-th occurrence of 
the regular expression expr. If 
there are less than i occurrences of 
expr , and the input is a file (rather 
than a pipe), then the position in 
the file remains unchanged. 

in 

Search for the i-th occurrence 

(single quote) Go to the point from 
which the last search started. 

.’command 

Invoke a shell with command. 

i:n 

skip to the i-th next file given in 
the command line (skips to last file 
if n doesn’t make sense) 

i:p 

:f 

Skip to the i-th previous file given 
in the command line. 

Display the current file name and 
line number. 

:q or :Q 

Exit from more 

(dot) Repeat the previous command. 


mt - magnetic tape manipulating 
program 

Syntax 

mt [-f tapename ] command [count] 


Options 


b6f 

Backspace count files. 

bsr 

Backspace count records. 

cache 

Allows mt to use the cache buffer 
on a tape drive that has the cache 
buffer feature. 
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clhrdsf 

clserex 

clsub 

eof, weof 

Clear hardware/software problem. 

Clear serious exception. 

Clear subsystem. 

Write count end*of-file marks at the 
current position on the tape. 

eotdis 

Disable end-of-tape detection. 

eoten 

Enable end-of-tape detection. 

fsf 

Forward-space count files. 

fsr 

nocache 

Forward-space count records. 

Disables the use of the cache buffer 
for any tape drive that has the 
cache buffer feature. 

offline, rewoffl 

Rewind the tape and place the tape 
unit off-line. 

rewind 

Rewind the tape. 

status 

Print status information about the 
tape unit. 


mv - move or rename files 

Syntax 

mv [-i] l-fl l~] fitel file2 

mv [-i] [-f] [-1 file... directory 


Options 

Interprets all following arguments as 
file names to allow file names 
stalling with a minus. 

-f 

Force. 
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-i Interactive mode. 

netstat - show network status 

Syntax 

netstat [ -Aan ] [ -f address-family ] [ system ] [ core 

netstat [ -himnrs ] [ -f address^family ] [ system ] [ 

core ] 

netstat [ -n ] [ -I interface ] interval [ system ] [ core 

] 

Options 

-A Displays the address of any 

associated protocol control blocks; 
used for debugging. 

-a Displays the information for all 

sockets. 

-f address^ family Limits statistics or address control 
block reports to those of the 
specified address family. 

Displays the state of the IMP host 
table. 

-I interface Shows information only about this 

interface. 

Displays status information for 
autoconfigured interfaces. 

~ m Displays information for the memory 

management routines The network 
manages a private share of memory. 

“ n Displays network addresses as 

numbers. 

” r Displays the routing tables. 
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-s 


Displays per-protocol statistics. 


-t 


Displays time until interface 
watchdog routine starts up (used 
only in conjunction with -i option). 



Syntax 


newaliases 


nice, nohup - execute a command 
at a lower priority 

Syntax 

nice [-number] command [arguments] 


nohup command [ arguments ] 


Options 


Increments the priority by a 
specified number up to a limit of 
20 . 


- number 


nl - line numbering filter 

Syntax 

nl [_h type] [-b type) [-f type] [-v startH) [-i incr) [-p 
] l-l num] [— s sep] [-w width ] [-n format] [-d delim] 
file 
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Options 


-b type 

Specifies which logical page body 
lines are to be numbered. 

The default type for logical page 
body is t (text lines numbered). 

-h type 

Same as -b type except for header. 

-f type 

Same as -b type except for footer. 

-P 

Do not restart numbering at logical 
page delimiters. 

-v starts 

The initial value used to number 
logical page lines. 

-i incr 

The increment value used to number 
logical page lines. 

- s sep 

The character used in separating the 
line number and the corresponding 
text line. 

-w width 

The number of characters used for 
the line number. 

-n format 

The line numbering format. 

-1 num 

The number of blank lines to be 
considered as one. 

-d xx 

The delimiter characters specifying 
the start of a logical page section 
may be changed from the default 
characters ( \) to two user-specified 
characters. 


nm - print program’s name list 

Syntax 

nm [ options ] ( file... ] 
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Options 

_ a Displays all symbols including debug 

symbol table. 

_ e Prints only global (external) 

symbols. 

Displays all symbols including debug 
symbol table. 

_ g Prints only global (external) 

symbols. 

_ n Sorts numerically rather than 

alphabetically. 

_ 0 Prepends file or archive element 

name to each output line. 

_ p Prints symbolic table order and does 

not sort. 

_ r Sorts in reverse order. 

_ u Displays only undefined symbols. 

nslookup - query BIND servers 
interactively 

Syntax 

/usr/ucb/nslookup [ A ] [ host A [ server A ] ] 

nslookup • A [ server A ] 

nsquery - name server query 

Syntax 

/usr/ucb/nsquery [ lookup ] [ host 1 [ server ] 
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Options 


lookup 

Retrieves the host name, IP 
address, and aliases of the specified 
host. 

host 

Specifies the system for which you 
want host information. 

server 

Specifies the BIND server you want 
to query for the information. 

od - 

create file octal dump 

Syntax 

od [ options] [file] [offset] [label] 

Options 

-a 

Interprets bytes as characters and 
display them with their ACSII 
names. 

-b 

Displays bytes as unsigned octal. 

-c 

Displays bytes as ASCII characters. 

-d 

Displays short words as unsigned 
decimal. 

-f 

Displays long words as floating 
point. 

-h 

Displays short words as unsigned 
hexadecimal. 

- i 

Displays short words as signed 
decimal. 

-1 

Displays long words as signed 
decimal. 

-o 

Displays short words as unsigned 
octal. 
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- s[n] 

Looks for strings of ASCII 
characters of n minimum length. 

- V 

Displays all data and indicates lines 
identical to the last line shown with 
an * in column 1. 

-w[rc] 

Specifies the number of input bytes 
to be interpreted and displayed on 
each output line. 

-X 

Displays short words as 
hexadecimal. 

4-» 

CO 

o 

a 

i 

o 

CO 

Q 

unpack - compress 

and expand 

files 

Syntax 

pack [ - ] [ -f 1 

name... 

peat name... 

unpack name... 

pagesize - 

print system page size 


Syntax 

pagesize 

passwd - change your login 
password 

Syntax 

passwd [name] 
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paste - merge file data 

Syntax 

paste filel file2... 

paste - d list filel file2... 

paste -s l- d list ] filel file2... 


Options 


- d list 

Used in place of any file name, to 
read a line from the standard input. 

Replaces characters of all but last 
file with nontabs characters (default 
tab). 

-s 

Merges subsequent lines rather than 
one from each input file. 


pc - Pascal compiler 

Syntax 

pc [ option ] name... 


Options 


-C 

Suppresses loading and produce .o 
files from source files. 

-g 

Produces additional symbol table 
information for dbx(1). 

- w 

-0 

Suppresses warning messages. 

Invokes an object-code improver. 

- o output 

Names the final output file output 
instead of a.out. 

■p 

Prepares object files for profiling. 
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s 

Compiles the named program, and 
leave the assembler-language output 
on the corresponding file suffixed .s. 

c 

Compiles code to perform runtime 
checks, verify assert calls, and 
initialize all variables to zero as in 

b 

■ i name 

pi. 

Block buffers the file output. 

Produces a listing for the specified 
procedures, functions and include 
files. 

-1 

Makes a program listing during 
translation. 

- s 

Accepts standard Pascal only and 
non-standard constructs cause 
warning diagnostics. 

- t directory 

Uses the given directory for 
compiler temporary files. 

-z 

Allows execution profiling with pxp 
by generating statement counters, 
and arranging for the creation of 
the profile data file pmon.out when 
the resulting object is executed. 


pdx - pascal debugger 

Syntax 

pdx [-r] [objfile] 


Options 


-r 

Causes obifile to be executed 
immediately. 
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P9 - * ,l,e P er . u sal filter for soft- 
copy terminals 


Syntax 

pg [-P l-cefsj [files 

Options 


-number 

Specifies the size (in lines) of the 
window that pg is to use instead of 
the default. 

- p string 

Uses the string as the prompt. 

-c 

Homes the cursor and clears the 
screen before displaying each page. 

-e 

Do not pause at the end of each 
file. 

-s 

Print all messages and prompt in 
standout mode (usually inverse 
video). 

+ linenumber 

Starts at linenumber. 

+/pattern/ 

Starts at the first line containing 
the regular expression, pattern. 


franslator Ca ' in,erpre,er code 

Syntax 

pi [ options ] [-i name...] name.p 


Options 


-b 

Block buffers the file output. 

-i 

Enables listing for specified 
procedures and functions and while 
processing specified include files. 
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Creates a program listing while 
translating source. 

Begins each listed include file on a 
new page with a banner line. 

Suppresses control flow backtrace on 
error; suppresses statement limit 
counting. 

Accepts standard Pascal only; non¬ 
standard constructs cause warning 
diagnostics. 

Suppresses runtime tests of 
subrange variables and treat; treats 
assert statements as comments. 

Runs in card image mode; only the 
first 72 characters of input lines are 
used. 

Suppresses all warning diagnostics. 

Enables execution profiling with pxp 
by generating statement counters, 
and arranging for the creation of 
the profile data file pmon.out when 
the resulting object is executed. 


pix - Pascal interpreter and 
executor 

Syntax 

pix t-blnpstuwz] [-i name...] name.p [argument...] 

Options 

_b Block buffers the output. 
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-i name 

Enables the listing for any specified 
procedures and functions, and while 
processing any specified include files. 

-1 

Creates a program listing while 
translating source. 

- n 

Begins each listed include file on a 
new page and with a banner line. 

“P 

Suppresses control flow backtraces 
on error. 

-s 

Accepts standard Pascal only. 

-t 

Suppresses runtime test of subrange 
variables. 

- u 

Runs in card image mode. 

- w 

Suppresses all warning diagnostics. 

-2 

Enables execution profiling. 


plot - graphics filters 


Syntax 

plot [- Tterminal[raster}] [-1#] [- w #] [-c#] 

Options 

-T terminal Uses the specified terminal name as 

the terminal type for which plotting 
instructions are to be generated. 

4020 Tektronix 4020 storage scope. 

450 DASI Hyterm 450 terminal (diablo 

mechanism). 

300 DASI 300 or GSI terminal (diablo mechanism). 
300S DASI 300S terminal (diablo mechanism), 

ver Versatec D1200A printer-plotter. 
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Ivpl6 DEC LVP16 Graphics Plotter. 
hp7475a HP 7475A Graphics Plotter. 


raster 

Is a scan-converted temporary file 
that is sent directly to the plotter. 

-1# 

length of paper window in plotter 
units (unit scale) 

-w# 

width of paper window in plotter 
units (unit scale) 

-c# 

initial pen carousel to be used 


pmerge - 

pascal file merger 

Syntax 

pmerge name.p.. 



pr - print files 

Syntax 

pr [ options ] [ files 1 


Options 


- a 

Prints multi-column output across 
the page. 

-b 

-d 

Prints blank headers. 
Double-spaces the output. 

-e ck 

Expands input tabs to character 
positions k+ 1, 2*k+l, 3*k+ 1,... 

-f 

Uses form-feed character for new 
pages. 
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-h 

Uses the next argument as the 
header to be printed instead of the 
file name. 

-i ck 

Replaces white space in output by 
inserting tabs to character positions 
k+ 1, 2*k+ 1, 3*k+ l,...n*k+ 1. 

+ k 

Begins printing with page k (default 
is 1). 

-k 

Produces k -column output (default is 
1). 

-1 k 

Sets the length of a page to k 
lines. 

-m 

Merges and prints all files 
simultaneously, one per column 
(overrides the -k, and -a options). 

-n ck 

Numbers lines. 

-o k 

Offsets each line by k character 
positions (default is 0). 

-P 

Pauses before beginning each page if 
the output is directed to a terminal. 

- r 

Suppresses diagnostic reports on 
failure to open files. 

-s c 

Separates columns by the single 
character c instead of by the 
appropriate number of spaces 
(default for c is a tab). 

-t 

Supresses the five-line identifying 
header and the five-line trailer 
normally supplied for each page. 

- w k 

Sets the width of a line to k 
character positions. 
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print - pr to the line printer 

Syntax 

print file... 

printenv - display value of a shell 
variable 

Syntax 

printenv [ name ] 

prmail - print out mail in the post 
office 

Syntax 

prmail [ user... ] 

prof - profile an object file 

Syntax 

prof [-a] [-1] [-n] [-z] [-s] [-v] 


lfHellftle2...]) 


Options 

-a 

Displays all symbols rather than 
just external symbols. 

-1 

Displays output by symbol value. 

-n 

Displays output by number of calls. 

-V 

Produces graphic output for display 
by the plot(lg) filters. 

-z 

Routines having zero usage, as 
indicated by call counts and 
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accumulated time, are printed in the 
output. 

ps - print process status statistics 

Syntax 

ps [options] [namelist] [core] 

Options 

Represents any given process 
number and must be the last option 
given. 

“ a Displays information for processes 

executed from all user terminals. 

“ c Displays command names which are 

stored internally in the system for 
accounting purposes rather than the 
command arguments, which are kept 
in the process address space. 

” e Displays the environment as well as 

the command arguments. 

Displays all processes. 

“ k Uses file /vmcore in place of 

/dev/kmem and /dev/mem. 

Displays information in long format. 

s Adds the size SSIZ of the kernel 

stack of each process to the basic 
output format for use by system 
maintainers. 

~ tx Displays information for specified 

terminal only. 

" u Displays user-oriented output, which 

includes fields USER, %CPU, and 
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%MEM, SIZE. 

_ v Displays process system time and 

user time in addition to cumulative 
time. 

_ w Produces 132-column rather than 80 

column output. 

_ x Displays information for all 

processes, including those not 
executed from terminals. 

ptx - create permuted index 

Syntax 

ptx [ option ... ] [input[output ]] 


Use the characters in the break file 
as separators. 

Folds upper and lower case letters 
for sorting. 

Uses specified number as interfield 

gap- 

Do not use as keywords any words 
given in the ignore file. 

Use words listed only in the only 
file. 

Uses leading nonblanks as reference 
identifiers. 

Prepares the output for the 
phototypesetter. 

Use the next argument, n, as the 
width of the output line. 


Options 

- b break 

-f 

-g n 

- i ignore 

- o only 
-r 

-t 

- w n 
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pwd - print working directory 

Syntax 

pwd 

px - Pascal code executor 

Syntax 

px [ obj[argument... ] ] 

pxp - Pascal execution profiler 

Syntax 

pxp [-acdefjnstuw_ ] (-23456789] [-z [name...]] name.p 

Options 



Underscores all keywords. 

-d 

Uses the specified number (-cO as 
the indentation unit. 

- a 

Displays all procedures (even those 
not executed). 

- c 

Uses the core file in generating the 
profiling data. 

-d 

Displays all declaration parts. 

- e 

Eliminates include directives when 
reformatting a file. 

-f 

Displays all parenthesized 
expression. 

“j 

Left justifies all procedures and 
functions. 

-n 

Begins a new page for each included 
file. 
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. s Strips comments from the input 

text. 

Prints a table summarizing 
procedure and function call counts. 

_ u Generates the output in card image 

format, using only the first 72 
characters of input lines. 

_ w Suppresses all warning diagnostics. 

_ z Generate an execution profile for 

the specified modules (next 
arguments). 

pxref - Pascal cross-reference 
program 

Syntax 

pxref [-] name 


Options 

Optional argument that suppresses 
the line numbered listing. 

auota - display disk usage and 
limits 

Syntax 

quota [-qv] [user] 


Options 

_ q Prints a message that contains 

information only on file systems 
where usage is over quota. 
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Displays users quotas on file 
systems where no storage is 
allocated. 


Tf!3li b " convert archives to 
random libraries 

Syntax 

ranlib archive... 

rep - remote file copy 

Syntax 

rep [ -p J filel fiU2 

rep [-r] f-p] file... directory 


Options 

~P Preserves the modification times and 

modes of the source files in its 
copies, ignoring the umask. 

“ r Copies files in all subdirectories 

recursively, if the file to be copied 
is a directory. 


~ find and format 
bibliographic references 


Syntax 


refer [-a] t-b] [-c] [-e] [-fn] f-lu] [-lm.nl 
bib] [-sAo's] [-Bim] [-P] [-S] [file...] 


t-n] [-p 
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Options 


- a r 

Reverses order of first author 
names. 

-B Lm 

Bibliography mode. 

-b 

Creates bare entries: no flags, 
numbers, or labels. 

- c keys 

Capitalizes fields whose key letters 
are in string. 

- e 

Accumulates all references in one 
list. 

- fn 

Set the footnote number to n 
instead of the default of 1 ( one). 

- kx 

Uses specified label in place of 
numbering for each reference data 
line beginning % x :. 

-1 m,n 

Instead of numbering references, use 
labels made from the senior author’s 
last name and the year of 

-P 

publication. 

Places punctuation marks after 

the reference signal, rather than 
before. 

- n 

Do not search the default file 
/usr/dict/papers/Ind. 

-p6i6 

Specifies file to be searched before 
/usr/dict/papers. 

-S 

Produce references in the Natural or 
Social Science format. 

- s keys 

Uses specified key in sorting 
references. 


2-84 Other Section 1 Commands 






reset - 

reset terminal mode 

Syntax 

reset 



inVe daTa rSe character Positions 

Syntax 

rev [file...} 


rlogin - 

remote login 

Syntax 



rlogin rhost [-ec] (-8] [-L] [-1 username ] 
rhost [-ec] [-8] [-L] (-1 username] 


Options 


-8 

Allows an 8-bit input data path at 
all times. 

-ec 

Uses the specified character as the 
rlogin escape character. 

-1 username 

Logs you in as the specified user, 
not as your user login name. 

-L 

Runs session in litout mode. 


or , ’dlrectories remOVe (Unlink) ,l,es 
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Syntax 

rm [-f] [-r] [-i] [-] fUe-or-directory-name... 
rmdir directory-name... 


Options 



Specifies that the named files have 
names beginning with a minus (for 
example -myfile ). 

-f 

Forces the removal of file or 
directory without first requesting 
confirmation. 

-i 

Prompts for yes or no response 
before removing each entry. 

-r 

Recursively removes all entries from 
the specified directory and, then, 
removes the entry for that directory 
from its parent directory. 


rmail - route mail to users on 
remote systems 


Syntax 

rmail user... 


roffbib - run off bibliographic 
database 

Syntax 

roffbib [options] [file...] 
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Options 


-T term 

Uses specified name as terminal 
type for which output is prepared. 

-X 

Suppresses the printing of abstracts. 

-e 

Formats text with equally spaced 
words, justified lines, and full 
resolution. 

-h 

Uses tabs in horizontal spacing to 
speed output and reduce output 
character count. 

- n 

Uses specified number (-nAD as 
first page to be printed. 

-o 

Uses specified list (- 0 list) as only 
pages to be printed. 

-s 

Stops after specified number of 
pages (-s n). 

- m mac 

Specifies a user-defined set of 
macros with space between -m and 
the macro file name. 

-V 

-Q 

Sends output to the Versatec. 

Queues output for the 
phototypesetter. 

-raN 

Sets named register a to specified 
value N. 


rsh - remote shell 

Syntax 

rsh host [-1 username] [-n] command 
host [-1 username] f-n] command 


Other Section 1 Commands 2-87 







Options 

- 1 username Logs you in as the specified user, 

not as your user login name. 

_ n Redirects all command input to 

/dev/null. 

ruptime — show host status of 
local machines 

Syntax 

ruptime 


Options 


- a 

Users idle an hour or more are not 
counted unless this option is 
specified. 

-d 

Display only those hosts that are 
considered down. 

-1 

Sort the status list by load average, 

-r 

Show only hosts that are up and 
running. 

-t 

Sort the status list by uptime. 

-u 

Sort the status list by number of 
users. 

- nn 

Show only those hosts with nn or 
more users. 

rwho - who is logged in on local 
machines 
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Syntax 

rwho [ -ah ] fusers] 


Options 

-a 

-h 


Lists all users. 

Sorts users by host name. 


sSmake - maintain, update, and 
regenerate groups of programs 


Syntax 

s5make [-f makefile ] [ t[ names) 

Options 

-b Compatibility mode for old 

makefiles. 

“ d Debug mode. 

e Environment variables override 

assignments within makefiles. 

- f makefile Description file name determined by 

makefile as next argument. 

Ignore error codes returned by 
invoked commands. 

Abandons work on current entry, 
but continues on other branches 
that do not depend on that entry. 

" m Displays a memory map showing 

text, data, and stack. 

“ n No execute mode. 

p Displays the complete set of macro 

definitions and target descriptions. 
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Question. 

Does not use built-in rules. 

Silent mode. 

Touches target files (causing them 
to be up-to-date) rather than issuing 
usual commands. 


script - generate script of your 
terminal session 

Syntax 

script [-a] [file] 

Options 

-a Appends output to output file. 

sed - stream text editor 

Syntax 

sed [-n] [-e script] [-f sfile] lfile...] 

Options 

- e script 

Uses specified file as input file of commands to 
be executed. 

-f sfile t „ , . 

Uses specified file as input file of commands to 

be executed. 

-n Suppresses all normal output. 
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size - print program’s sizes 

Syntax 

size [object... ] 

sleep - suspend execution for a 
time 

Syntax 

sleep time 

soelim - eliminate nroff source 
directives from nroff input 

Syntax 

soelim [file... ] 

Options 

File name corresponding to standard input. 

sort - sort file data 

Syntax 

sort [ options ] l+posl [~pos2]] [file...] 

Options 

-b Ignores leading blanks (spaces and tabs) in field 
comparisons. 

-d Sorts data according to dictionary ordering: 
letters, digits, and blanks only. 
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-f Folds uppercase to lowercase while sorting. 

-i Ignore characters outside the ASCII range 040- 
0176 in nonnumeric comparisons. 

-n Sorts fields with numbers numerically. 

-r Reverses the sense of comparisons. 

-tx Uses specified character as field separator. 

-c Checks sorting order and displays output only if 
out of order. 

-m Merges previously sorted data. 

-o name 

Uses specified file as output file. 

-TdirUses specified directory to build temporary files, 
-u Suppresses all duplicate entries. 


sorts - internationalized System 5 
sort and/or merge files 

Syntax 

sort5 [/ifes] 

Options 


-C 


- m 


-u 


-o output 


Checks that the input file is sorted 
according to the ordering rules; 
gives no output unless the file is 
out of order. 

Merges only; the input files are 
already sorted. 

Suppresses all but one in each set 
of lines having equal keys. 

Specifies the name of an output file 
to use instead of the standard 
output. 
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-ykmem 

Specifies the number of kilobytes of 
memory to use when sorting a file. 

- 2 recsz 

Records the size of the longest line 
read in the sort phase so buffers 
can be allocated during the merge 
phase. 

-d 

Sorts using tags. 

Specifies Dictionaiy order. 

-f 

Folds lower case letters into upper 
case. 

- i 

Ignores characters outside the 

ASCII range 040-0176 in 
nonnumeric comparisons. 

-n 

Sorts an initial numeric string, 
consisting of optional blanks, 
optional minus sign, and zero or 
more digits with optional decimal 
point, by arithmetic value 

-r 

Reverses the sense of comparisons. 

sortbib - 
database 

sort bibliographic 

Syntax 



sort bib [-s/CEYS] database... 

Options 

-sKEYS 

Specifies new sort KEYS. 
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spell, spellin, spellout - check text 
for spelling errors 


Syntax 

spell [-v] [-b] [-x] [-d hlist] [+ localfile] [-s hstop] 
[-h spellhist] [file...] 
spellin [list] 
spellout [-d] list 


Options 

-V Displays words not found in spelling list with all 
plausible derivations from spelling list. 

-b Checks data according to British spelling. 

-x Precedes each word with an equal sign ( = ) and 
displays all plausible derivations. 

- d hlist 

Specifies the file used for the spelling list. 


- h spellhist 

Specifies the file used as the history file. 


- s hstop 

Specifies the file used for the stop list. 


-I- local-file 

Removes words found in local-file 
of the spell command. 


from the output 


spline - interpolate smooth curve 


Syntax 

spline [ option... ] 
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Options 

-a Supplies abcissa automatically and uses specified 
number (next argument) for spacing. 

-k Sets the boundary constant to the specified value 
(next argument). 

-n Uses specified number ( n) in calculating intervals 
between lower and upper limits. 

— p Periodically produces output (matches derivates at 
ends). 

-x Uses specified numbers (next arguments) as lower 
and upper limits. 

split - split file into smaller files 

Syntax 

split [-n] [file[name]] 

Options 

- Uses standard input. 

-n Writes specified number of lines to each output 
file. 

strextract - batch string extraction 

Syntax 

strextract [ -p patternfile ] [ -i ignore file ] [ -d ] [ 

file... ] 
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Options 

-i Specifies a new ignore file to be used to instruct 
strextract to ignore specific text strings. 

-p Specifies a new pattern file to be used. 

-d If this flag is set warnings are not printed for 
duplicate strings. 

strings - print ASCII strings in 
program 

Syntax 

strings 1—] [—o] [—number] /i/e... 

Options 

Looks through the entire object file for ASCII 
strings. 

- number 

Sets the minimum string length to specified 
number of characters and default is 4. 

-o Precedes each string with its file offset (octal). 

strip - remove symbol table and 
relocation bits 

Syntax 

strip name... 

strmerge - batch string 
replacement 
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Syntax 

strmerge [ -m prefix ] [ -p patternfile ] [ -s string ] 
file.. 

Options 

-m Specifies a prefix to message numbers in the nl_ 
file and the file. 

-p Specifies a new pattern file to be used. 

-s Specifies a string to be output at the start of the 
file. 

style - analyze surface 
characteristics of a document 

Syntax 

style [-ml] [-mm] [-a] [— e] [-1 num] [-r num] [— p] 
[-P] file... 

Options 

-a Displays all sentences with their length and 
readability index. 

-e Displays all sentences that begin with an 
expletive. 

- 1 num 

Displays all sentences longer than num. 

-ml Skips lists in document. 

-mmOverrides the default macro package -ms. 

- P Displays parts of speech of the words in the 

document. 

-p Displays all sentences that contain a passive verb. 
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— i riuni . j 

Displays all sentences whose readability index is 
greater than num. 

su - substitute a user ID 

Syntax 

su [ userid] 

Options 

Prevents csh(l) from executing the .cshrc file, making 
su start up faster. 

- Simulates a full login. 

sum - print object file’s checksum 

Syntax 

sum file 

symorder - rearrange name list 

Syntax 

symorder orderlist symbolfile 

sync - update the super block 

Syntax 

/bin/sync 
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tabs - set tabs 

Syntax 

tabs [— n] [terminal] 

Options 

-n Does not indent left margin. 

tail - print lines from file 

Syntax 

tail [ ±fnumber][lbc)[fr] ] [ file ] 

talk - talk to another user 

Syntax 

talk person [ tty name ] 

tar - multivolume archiver 

Syntax 

tar [ key ] [ name ... ] 

Options 

C Create a new archive on tape, disk, or file. 

r Write the named files to the end of the archive. 

t List the names of the files as they occur on the 
input archive. 

u Add the named files to the archive if they are 
not there already or if they have been modified 
since they were last put in the archive. 
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x Extract the named files from the archive. 

0...9 Substitute a number for the device unit number, 
as in /dev/rmt#h. 

A Use next argument as archive number with which 
to begin output. 

B Force input and output blocking to 20 
blocks/record. 

D Directory output in original tar style. 

F[F] Operate in fast mode. 

H Help mode. 

M Next arg spedifies maximum archive number to 

be written and prints current archive number on 
output line. 

N No multi-archive, file splitting, or new header 
format on output. 

O Include file owner and group names in verbose 
output if present in archive header (t and x 
functions). 

P Used to specify POSIX format tapes. 

S Output User Group Standard archive format. 

V Display extended verbose information. 

b Use the next argument as the blocking factor for 
tape records. 

d Use /dev/rrala as the default device (blocking- 
factor of 10). 

f Use the next argument as the name of the 
archive instead of /def/rmtOh. 

h Save a copy of the actual file on the output 

device under the shmbolic link name, instead of 
placing the symbolic information on the output. 

i Ignore checksum errors found in the archive. 

1 Complain if tar cannot resolve all of the links to 

the files dumped. 
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m Do not restore the modification times. 

o Suppress the normal directory information. 

P Restore the named files to their original modes, 
ignoring the present umask(2). 

s Next argument specifies size of archive in 512- 
byte blocks. 

Write the name of each file treated, preceded by 
the function letter, to diagnostic output. 

w Print the action to be taken, followed by file 
name, then wait for user confirmation. 

troff format tab,es for nroff or 

Syntax 

tW [files...) 

file ~ f,ipe out P ut t0 terminal and 

Syntax 

tee (-i] [-a] [file...) 

Options 

-a Appends input to existing files. 

- i Ignores interrupts. 

tt/mSct us ? r interface to the 
TELNET protocol 
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Syntax 

telnet ( host\port ]] 

test - test conditional expression 

Syntax 

test expr 

test - condition evaluation 
command 

Syntax 

test expr 
[ expr ] 

tftp - trivial file transfer program 

Syntax 

tftp [frost] [port] 

time - time a command 

Syntax 

time command 

tip, cu - connect to a remote 
system 

Syntax 

tip [— v] [-speed] systemrname 
tip [-v] [-speed] phone-number 

cu phone-number [-1] [-s speed) [-a acu) [-1 line ] 
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I-#] 


Options 

-# Uses specified speed (#) as baud rate. 

-1 Uses specified terminal line. 

-v Displays all variable settings. 

■CTRL/D-. 

Drop the connection and exit (you may still be 
logged in on the remote machine), 
c [name] 

Change directory to name (no argument causes , 
change to your home directory). 

1 Escape to a shell (exiting the shell returns you 

Copy file from local to remote. 

Copy file from remote to local. 
from [ to ] 

Send a file to a remote UNIX host. 

Take a file from a remote UNIX host. 

fr, nMTY UtPUt fr0m 8 rem0te command to a 
local UNIX process. 

Send a BREAK to the remote system. 

Sets a variable. 

Displays sets as they are made. 

UTRL/Z 

Stop tip (only available with job control). 

7 Dis Plays a summary of the tilde escapes 

how * The ‘f Utility 11868 the file /etc/remote to find 

it° should 6aCh a , pm ? i< ; ular 8ystem and to find out how 
it should operate while talking to the system 


> 

*< 

1 > 

\ 

1 

Tf 

8 

\ 
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touch - update access and 
modification times of a file 


Syntax 

touch [ - amcf ] [ mmddhhmmtyy] 1 files 

Options 

_ a Causes touch to update the access 

time. 

_ c Prevents touch from creating the 

file if it did not previously exist. 

_f Attempts to force the touch in spite 

of read and write restrictions on a 
file. 

_ m Causes touch to update the 

modification time. 

tr - translate characters 

Syntax 

tr [- cds] [stringl[string2 ]] 

Options 

-c Translates complements: stringl to those not in 
stringl. 

-d Deletes all characters in stringl from output. 

-s Squeezes succession of a character in stringl to 
one in output. 
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trace - trace system calls of 


Syntax 

trace (options ] and args... 

Options 

- f filename 

Puts dump in file filename . 

-z Echos arguments only. 

-c* Traces given PIDs and their children, 

-g# Traces given groups only. 

-p# Traces given PIDs only. 

-s# Traces given system calls only. 

-u^ Traces given UIDs only. 


trans - translation tool for use 
with message source files 


Syntax 

trans t — c ] [ — o name ] file, ms f 

Options 

-c Translate comment lines beginning with a dollar 
sign ($), including messages. 

— o Call the output file name. 

true, false - test for status 
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Syntax 

true 

false 

tset - set terminal mode 

Syntax 

tset [options] [-m[ident] [test baudrate ]:type] ... [ type 

] 

reset ... 

Options 

Name of terminal is output on stndout, captured 
by the shell, and placed in the environment 
variable TERM. 

-ec Uses the specified character as the erase 
character. 

-I Suppresses transmitting terminal initialization 
strings. 

-kc Uses the specified character as the kill character, 
-n Initializes the “new” tty driver, if applicable. 

-Q Suppresses erase and kill character message. 

tsort - create topological sort 

Syntax 

tsort [file] 

tty - print current terminal name 
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Syntax 

tty [-s] 

Options 


-8 Suppresses pathname. 


terminaf CeSS underscores for 


Syntax 

ul t-i] [-t terminal [name...] 


Options 

-i Displays underscoring on separate line containing 
appropriate dashes (-). 

- t terminal 

Uses type of specified terminal in place your 
terminal’s type. 


uniq - report repeated lines in a 


Syntax 

umq f- udc [+ n] [- n] ] [ input [output ] ] 

Options 

-n Skips specified number of fields. 

+ n Skips specified number of characters in addition to 
fields. 

-c Displays number of repetitions, if any, for each 
line. 
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-d Displays only lines that were repeated. 

-u Displays only unique (nonrepeated) lines. 

uptime - display system status 

Syntax 

uptime [-wi 

users - print names of users who 
are logged in 

Syntax 

users 

uucp, uulog, uuname - unix to 
unix copy 

Syntax 

uucp [option...] source-file... destination-file 
uulog [ option... 1 
uuname [option...] 

Options 

-d Creates all necessary directories for the file copy. 

-c Uses the source file when copying out rather than 
copying the file to the spool directory. 

-m Sends you mail when the copy is complete. 

- nrecSends mail to the recipient. 

-W Expands only local files. 

- ssysDisplays information about work involving specified 

system. 
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- u user 

Displays information about work involving specified 

user. 

-1 Lists local system name. 


uuencode, uudecode - 
encode/decode a binary file for 
transmission via mail 


Syntax 

uuencode [file) remotedest | mail sysl\sys2\..'.decode 
uudecode [file] 

uusend - send a file to a remote 
host 

Syntax 

uusend [ -m mode ] sourcefile sysl!sys2!..!remotefile 

Options 


- m mode 

Specifies octal number for mode of file on the 
remote system. 


uustat - uucp status 
job control 


inquiry and 


Syntax 

uustat [ options ] 
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Options 

-chour 

Removes entries older than specified hour. 

-j all Reports status of all requests. 

- Vjobn 

Kills specified job. 

- mmch 

Reports status of accessibility of machine mch. 

-ohour 

Reports status of requests which are older than 
specified hour. 

-ssysReports status of uucp requests for specified 
system. 

- u user 

Reports status of requests issued by specified user, 
-v Invokes verbose printout option. 

-y hour 

Reports status of all requests that are younger 
than specified hour. 

system 

is the system in question 
status_time 

is the time the last status entry was made. 
last_ success_ time 

is the last time a connection was successfully 
made to this system. 

statusis a self-explanatory description of the machine 
status. 

uux - unix to unix command 
execution 
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Syntax 

UUX [- ] command-string 


Options 

-c, Do not copy local file to the spool directory for 
transfer to the remote machine. 

-g grade 

Specifies the grade which is a single letter or 
number from 0 to 9, A to Z, or a to z. 

-n Sends no notification to user. 

- p, Reads st din. 

-r Queues the job, but does not start the file 
transfer. 

-xdebug 

Produces debugging output on stdout. 

-z Notify the user if the command fails. 

vc ~ version control program 

Syntax 

vc [-a] [— t] f-c char] [-a] lkeyword^ value... 
keyword- value ] 

Options 

-a Replaces the keywords surrounded by control 
characters in all text lines. 

- c char 

Specifies a control character to be used in place 
of :. 

-s Suppresses all warning messages. 

-t Ignores all characters from the beginning of the 
line to the first tab character. 
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vcc 


VAX C compiler 


Syntax 

vcc [option...] file... 


Options 


The following is a 
cross_reference 

debug 


list of the available options: 

Generates a cross reference 
listing section 

Generates a loadable module 
for use with dbx 


define 

g_float 

list 

machine_code 

object 

optimize 

show 


Assign a specified value to a 
name 

Uses the G_floating point 
type 

Generates a list file 
Generates the machine code 
listing section 

Generates an object file with 

a specific name 

Selects code optimization 

Includes symbol and 
intermediate expansions 


standard Selects portability mode 

undefine Revokes the assignment of a 

value to a name 


warnings Disables warning or 

informational messages 
-w Suppresses warning diagnostics. 
-DSYSTEM_FIVE is added to the vaxc command 
(or cpp command if - E is specified). 
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• The Ik parameters -lc, -leg, or -lc_p are 
preceded with -lcV, -lcVg, or -lcV_p (if not 
supressed by -b). 

• The Ik parameters -lm, -Img, or -Imp are 
changed to -lmV, -lmVg, or -lmV_p (if present). 

vdoc - Compound document 


Syntax 

vdoc [ -f format ) l -O file ) ( -P processing ) ( -D 
display ] file 


Options 

-f Specifies the format of the input file. 

-0 Names a file containing the processing options to 
be used by the front end converter. 

-P Specifies the processing options to be applied 
during the veiwing of the file. 

-D Specifies the content elements of the file to be 
represented 


sS?‘s a t!cS report virtual memor y 

Syntax 

vmstat [- fsSzk] [ interval[count} ] (namelist core file] 


Options 

-f Displays number of forks and vforks since system 
startup and number of pages of virtual memory 
involved in each kind of fork. 
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-s Displays total number of paging-related events 
occurring since boot. 

-S Replaces the page reclaim (re) and pages attached 
(at) fields with processes swapped in (si) and 
processes swapped out (so). 

-k Allows a dump to be interrogated to print the 
contents of the sum structure (default). 

-z Zeroes out the sum structure. 

w - display who is logged in and 
what they are doing 

Syntax 

w [-h] [-s] [-1] [user] 

Options 

- d Outputs debug information. 

— h Suppresses the normal header from the output. 

-1 Displays information in long format (default). 

-s Displays information in short format. 

-u Outputs the same information as the uptime 
command. 

wait - wait for process completion 

Syntax 

wait [pid\ 

wall - write to all users 
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Syntax 

wall 


characters'* WOrds ' Hnes ’ and 


Syntax 

wc [-lwc] [name...] 


Options 

-c Displays number of characters only. 
-1 Displays number of lines only. 

-w Displays number of words only. 

de h s a c , rfptTon iSp,ay eommand 

Syntax 

what is command... 


* h H er ®j s - ,oc ate source, binary, 
and or manual for program 


Syntax 

whereis (-sbm] [-u] f-SBM dir... -f] name. 


Options 

-S dir 

Search for source files in specified directory. 

-B dir 

Search for binary files in given directory. 
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Search for manual section files in given directory. 

— b Searches only for binary files. 

_f Terminates last directory list created from use of 
-S, -B or -M flags and signals the start of file 

names. 

-m Searches only for manual section files. 

-s Searches only for source files. 

-u Searches for files that do not have one of binary, 
source or manual section files. 

which - locate program file 

Syntax 

which t name... ] 

who - print who and where users 
are logged in 

Syntax 

who [ who-file ] [am i] 

whoami - print your current login 
name 

Syntax 

whoami 

write - write message to another 
user 
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Syntax 

write user [ttyname] 


xaras - construct argument list 
ana execute command 

Syntax 

xargs [flags] [ command [initial-arguments] ] 

Options 


-1 number 

Execute the command for each non¬ 
empty number of lines of arguments 
from standard input. 

- i replstr 

Execute the command for each line 
from standard input, taking the 
entire line as a single argument and 
inserting it in initial arguments for 
each occurance of replstr. 

- nnumber 

Execute the command using as 
many standard input arguments as 
possible, up to the specified number. 

-t 

Echo the command and each 
constructed argument list to fd2 
prior to their extraction. 

•P 

Asks the user whether or not the 
command should be executed each 
time it is invoked. 

■X 

Causes the command xargs to 
terminate if an argument list is 
greater than the specified size of 
characters. 

s size 

The maximum size of each 
argument list is set to size 
characters. 


Other Section 1 Commands 2-117 





- eeofstrR The logical end-of-file string. 

xstr - extract strings from C 
program 

Syntax 

xstr [— c] [-] [file) 

Options 

Reads stdin. 

-c Extracts strings from specified C source (next 
argument). 

yacc - yet another compiler- 
compiler 

Syntax 

yacc [-vd] grammar 


Options 

-d Writes all define statements to y.tab.h file. 

-v Writes description of parsing tables and report of 
grammatical conflicts to y.output file. 

yes - be repetitively affirmative 

Syntax 

yes [arg] 
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vpcat - print values from a YP 
data base 

Syntax 

ypcat f— k] [-t] [- d domainname] mname 
ypcat -x 

Options 

-d domainname 

Displays information on the domain specified by 
domainname. 

-k Displays keys for maps in which values are null 
or key is not part of the value. 

— t Inhibits translation of mname to mapname. 

-x Displays map nickname table. 

ypmatch - print the value of one 
or more keys from a yp map 

Syntax 

ypmatch [-d domain ] I— k] [— t] key... mname 
ypmatch -x 

Options 

-d Displays key values for specified domain. 

-k Displays key, followed by a colon (:), before 
displaying value of the key. 

— t Inhibits translation of nickname to mapname. 

-x Displays map nickname table. 
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